From patchwork Fri May 31 06:12:02 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108075 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ9915Krz9s00 for ; Fri, 31 May 2019 16:21:49 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ986HsFzDqbD for ; Fri, 31 May 2019 16:21:48 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0J75TyzDqXt for ; Fri, 31 May 2019 16:14:08 +1000 (AEST) Received: from pps.filterd (m0098394.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64MAo078773 for ; Fri, 31 May 2019 02:14:05 -0400 Received: from e11.ny.us.ibm.com (e11.ny.us.ibm.com [129.33.205.201]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stv42d05r-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:04 -0400 Received: from localhost by e11.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:03 +0100 Received: from b01cxnp23032.gho.pok.ibm.com (9.57.198.27) by e11.ny.us.ibm.com (146.89.104.198) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:00 +0100 Received: from b01ledav005.gho.pok.ibm.com (b01ledav005.gho.pok.ibm.com [9.57.199.110]) by b01cxnp23032.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6Dxre36438404 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:13:59 GMT Received: from b01ledav005.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B7297AE064 for ; Fri, 31 May 2019 06:13:59 +0000 (GMT) Received: from b01ledav005.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 3320EAE05F for ; Fri, 31 May 2019 06:13:59 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav005.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:13:59 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 532024E87D2; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:02 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-2213-0000-0000-0000039856A9 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:01 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-2214-0000-0000-00005EA4D92F Message-Id: <20190531061351.22973-2-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 001/110] doc: flesh out OPAL return codes documentation X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Ensure we can link to each return code, as well as document when each one was introduced. Signed-off-by: Stewart Smith --- doc/opal-api/return-codes.rst | 314 ++++++++++++++++++++++++++-- doc/release-notes/skiboot-5.1.0.rst | 2 + 2 files changed, 295 insertions(+), 21 deletions(-) diff --git a/doc/opal-api/return-codes.rst b/doc/opal-api/return-codes.rst index 8378ee1b6b0c..296675d5aed7 100644 --- a/doc/opal-api/return-codes.rst +++ b/doc/opal-api/return-codes.rst @@ -10,22 +10,116 @@ by a negative return code. Conforming host Operating Systems MUST handle return codes other than those listed here. In future OPAL versions, additional return codes may be added. -In the reference implementation (skiboot) these are all in include/opal.h. +In the reference implementation (skiboot) these are all in `include/opal-api.h`_ + +.. _include/opal-api.h: https://github.com/open-power/skiboot/blob/master/include/opal-api.h + +There have been additions to the return codes from OPAL over time. A conforming +host OS should gracefully handle receiving a new error code for existing calls. + +An OS running on a POWER8 system only has to know about error codes that existed +when POWER8 with OPAL was introduced (indicated by YES in the POWER8 column below). +Additional OPAL error codes *may be returned on POWER8 systems* and as such OSs +need to gracefully handle unknown error codes. + +An OS running on POWER9 or above must handle all error codes as they were when +POWER9 was introduced. We use the placeholder "v1.0" version for +"since the dawn of time" even though there never was a skiboot v1.0 + ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| Name | Return Code | POWER8 GA | POWER9 GA | skiboot version where introduced | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_SUCCESS` | 0 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_PARAMETER` | -1 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_BUSY` | -2 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_PARTIAL` | -3 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_CONSTRAINED` | -4 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_CLOSED` | -5 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_HARDWARE` | -6 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_UNSUPPORTED` | -7 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_PERMISSION` | -8 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_NO_MEM` | -9 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_RESOURCE` | -10 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_INTERNAL_ERROR` | -11 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_BUSY_EVENT` | -12 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_HARDWARE_FROZEN` | -13 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_WRONG_STATE` | -14 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_ASYNC_COMPLETION` | -15 | YES | YES | v1.0 (initial release) | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_EMPTY` | -16 | NO | YES | v4.0 | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_I2C_TIMEOUT` | -17 | NO | YES | :ref:`skiboot-5.1.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_I2C_INVALID_CMD` | -18 | NO | YES | :ref:`skiboot-5.1.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_I2C_LBUS_PARITY` | -19 | NO | YES | :ref:`skiboot-5.1.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_I2C_BKEND_OVERRUN` | -20 | NO | YES | :ref:`skiboot-5.1.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_I2C_BKEND_ACCESS` | -21 | NO | YES | :ref:`skiboot-5.1.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_I2C_ARBT_LOST` | -22 | NO | YES | :ref:`skiboot-5.1.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_I2C_NACK_RCVD` | -23 | NO | YES | :ref:`skiboot-5.1.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_I2C_STOP_ERR` | -24 | NO | YES | :ref:`skiboot-5.1.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_XSCOM_BUSY` | OPAL_BUSY | NO | YES | :ref:`skiboot-5.4.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_XSCOM_CHIPLET_OFF` | OPAL_WRONG_STATE | NO | YES | :ref:`skiboot-5.4.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_XSCOM_PARTIAL_GOOD` | -25 | NO | YES | :ref:`skiboot-5.4.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_XSCOM_ADDR_ERROR` | -26 | NO | YES | :ref:`skiboot-5.4.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_XSCOM_CLOCK_ERROR` | -27 | NO | YES | :ref:`skiboot-5.4.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_XSCOM_PARITY_ERROR` | -28 | NO | YES | :ref:`skiboot-5.4.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_XSCOM_TIMEOUT` | -29 | NO | YES | :ref:`skiboot-5.4.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_XSCOM_CTR_OFFLINED` | -30 | NO | YES | :ref:`skiboot-5.4.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_XIVE_PROVISIONING` | -31 | NO | YES | :ref:`skiboot-5.5.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_XIVE_FREE_ACTIVE` | -32 | NO | YES | :ref:`skiboot-5.5.0` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ +| :ref:`OPAL_TIMEOUT` | -33 | NO | YES | :ref:`skiboot-5.8` | ++--------------------------------+------------------+-----------+-----------+----------------------------------+ The core set of return codes are: +.. _OPAL_SUCCESS: + OPAL_SUCCESS ------------ -:: +.. code-block:: c #define OPAL_SUCCESS 0 Success! +.. _OPAL_PARAMETER: + OPAL_PARAMETER -------------- -:: +.. code-block:: c #define OPAL_PARAMETER -1 @@ -34,66 +128,82 @@ invalid OPAL call. To determine if a specific OPAL call is supported or not, OPAL_CHECK_TOKEN should be called rather than relying on OPAL_PARAMETER being returned for an invalid token. +.. _OPAL_BUSY: + OPAL_BUSY --------- -:: +.. code-block:: c #define OPAL_BUSY -2 Try again later. Related to `OPAL_BUSY_EVENT`, but `OPAL_BUSY` indicates that the caller need not call `OPAL_POLL_EVENTS` itself. **TODO** Clarify current situation. +.. _OPAL_PARTIAL: + OPAL_PARTIAL ------------ -:: +.. code-block:: c #define OPAL_PARTIAL -3 The operation partially succeeded. +.. _OPAL_CONSTRAINED: + OPAL_CONSTRAINED ---------------- -:: +.. code-block:: c #define OPAL_CONSTRAINED -4 **FIXME** +.. _OPAL_CLOSED: + OPAL_CLOSED ----------- -:: +.. code-block:: c #define OPAL_CLOSED -5 **FIXME** document these +.. _OPAL_HARDWARE: + OPAL_HARDWARE ------------- -:: +.. code-block:: c #define OPAL_HARDWARE -6 **FIXME** document these +.. _OPAL_UNSUPPORTED: + OPAL_UNSUPPORTED ---------------- -:: +.. code-block:: c #define OPAL_UNSUPPORTED -7 Unsupported operation. Non-fatal. +.. _OPAL_PERMISSION: + OPAL_PERMISSION --------------- -:: +.. code-block:: c #define OPAL_PERMISSION -8 Inadequate permission to perform the operation. +.. _OPAL_NO_MEM: + OPAL_NO_MEM ----------- -:: +.. code-block:: c #define OPAL_NO_MEM -9 @@ -104,10 +214,11 @@ from this heap. If this is ever hit, you should likely file a bug. +.. _OPAL_RESOURCE: OPAL_RESOURCE ------------- -:: +.. code-block:: c #define OPAL_RESOURCE -10 @@ -116,33 +227,41 @@ While OPAL_BUSY indicates that OPAL may soon be able to proces the requent, OPAL_RESOURCE is a more permanent error and while the resource *may* become available again in the future, it is not certain that it will. +.. _OPAL_INTERNAL_ERROR: + OPAL_INTERNAL_ERROR ------------------- -:: +.. code-block:: c #define OPAL_INTERNAL_ERROR -11 Something has gone wrong inside OPAL. This is likely a bug somewhere and we return OPAL_INTERNAL_ERROR for safety. +.. _OPAL_BUSY_EVENT: + OPAL_BUSY_EVENT --------------- -:: +.. code-block:: c #define OPAL_BUSY_EVENT -12 The same as `OPAL_BUSY` but signals that the OS should call `OPAL_POLL_EVENTS` as that may be required to get into a state where the call will succeed. +.. _OPAL_HARDWARE_FROZEN: + OPAL_HARDWARE_FROZEN -------------------- -:: +.. code-block:: c #define OPAL_HARDWARE_FROZEN -13 +.. _OPAL_WRONG_STATE: + OPAL_WRONG_STATE ---------------- -:: +.. code-block:: c #define OPAL_WRONG_STATE -14 @@ -150,9 +269,11 @@ The requested operation requires a (hardware or software) component to be in a different state. For example, you cannot call OPAL_START_CPU on a CPU that is not currently in OPAL. +.. _OPAL_ASYNC_COMPLETION: + OPAL_ASYNC_COMPLETION --------------------- -:: +.. code-block:: c #define OPAL_ASYNC_COMPLETION -15 @@ -167,9 +288,11 @@ pseudo-code for an async call: :: rc = opal_async_wait(token); // handle result here +.. _OPAL_EMPTY: + OPAL_EMPTY ---------- -:: +.. code-block:: c #define OPAL_EMPTY -16 @@ -177,17 +300,166 @@ The call was successful and the correct result is empty. For example, the OPAL_IPMI_RECV call can succeed and return that there is no waiting IPMI message. -I2C Calls ---------- -Added for I2C, only applicable to I2C calls: :: +.. _OPAL_I2C_TIMEOUT: + +OPAL_I2C_TIMEOUT +---------------- +.. code-block:: c #define OPAL_I2C_TIMEOUT -17 + + +.. _OPAL_I2C_INVALID_CMD: + +OPAL_I2C_INVALID +---------------- +.. code-block:: c + #define OPAL_I2C_INVALID_CMD -18 + + +.. _OPAL_I2C_LBUS_PARITY: + +OPAL_I2C_LBUS_PARITY +-------------------- +.. code-block:: c + #define OPAL_I2C_LBUS_PARITY -19 + + +.. _OPAL_I2C_BKEND_OVERRUN: + +OPAL_I2C_BKEND_OVERRUN +---------------------- +.. code-block:: c + #define OPAL_I2C_BKEND_OVERRUN -20 + + +.. _OPAL_I2C_BKEND_ACCESS: + +OPAL_I2C_BKEND_ACCESS +--------------------- +.. code-block:: c + #define OPAL_I2C_BKEND_ACCESS -21 + +.. _OPAL_I2C_ARBT_LOST: + +OPAL_I2C_ARBT_LOST +------------------ +.. code-block:: c + #define OPAL_I2C_ARBT_LOST -22 + +.. _OPAL_I2C_NACK_RCVD: + +OPAL_I2C_NACK_RCVD +------------------ +.. code-block:: c + #define OPAL_I2C_NACK_RCVD -23 + +.. _OPAL_I2C_STOP_ERR: + +OPAL_I2C_STOP_ERR +----------------- +.. code-block:: c + #define OPAL_I2C_STOP_ERR -24 +.. _OPAL_XSCOM_BUSY: + +OPAL_XSCOM_BUSY +--------------- + +An alias for :ref:`OPAL_BUSY` + +.. _OPAL_XSCOM_CHIPLET_OFF: + +OPAL_XSCOM_CHIPLET_OFF +---------------------- + +An alias for :ref:`OPAL_WRONG_STATE` + +.. _OPAL_XSCOM_PARTIAL_GOOD: + +OPAL_XSCOM_PARTIAL_GOOD +----------------------- + +.. code-block:: c + + #define OPAL_XSCOM_PARTIAL_GOOD -25 + +.. _OPAL_XSCOM_ADDR_ERROR: + +OPAL_XSCOM_ADDR_ERROR +--------------------- + +.. code-block:: c + + #define OPAL_XSCOM_ADDR_ERROR -26 + +.. _OPAL_XSCOM_CLOCK_ERROR: + +OPAL_XSCOM_CLOCK_ERROR +---------------------- + +.. code-block:: c + + #define OPAL_XSCOM_CLOCK_ERROR -27 + +.. _OPAL_XSCOM_PARITY_ERROR: + +OPAL_XSCOM_PARITY_ERROR +----------------------- + +.. code-block:: c + + #define OPAL_XSCOM_PARITY_ERROR -28 + +.. _OPAL_XSCOM_TIMEOUT: + +OPAL_XSCOM_TIMEOUT +------------------ + +.. code-block:: c + + #define OPAL_XSCOM_TIMEOUT -29 + +.. _OPAL_XSCOM_CTR_OFFLINED: + +OPAL_XSCOM_CTR_OFFLINED +----------------------- + +.. code-block:: c + + #define OPAL_XSCOM_CTR_OFFLINED -30 + +.. _OPAL_XIVE_PROVISIONING: + +OPAL_XIVE_PROVISIONING +---------------------- + +.. code-block:: c + + #define OPAL_XIVE_PROVISIONING -31 + +.. _OPAL_XIVE_FREE_ACTIVE: + +OPAL_XIVE_FREE_ACTIVE +--------------------- + +.. code-block:: c + + #define OPAL_XIVE_FREE_ACTIVE -32 + +.. _OPAL_TIMEOUT: + +OPAL_TIMEOUT +------------ + +.. code-block:: c + + #define OPAL_TIMEOUT -33 diff --git a/doc/release-notes/skiboot-5.1.0.rst b/doc/release-notes/skiboot-5.1.0.rst index d48dc0b3ae86..d7e65792e931 100644 --- a/doc/release-notes/skiboot-5.1.0.rst +++ b/doc/release-notes/skiboot-5.1.0.rst @@ -1,3 +1,5 @@ +.. _skiboot-5.1.0: + skiboot-5.1.0 ============= From patchwork Fri May 31 06:12:03 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108057 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ361qH8z9sB8 for ; Fri, 31 May 2019 16:16:34 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ360v5LzDqZ1 for ; Fri, 31 May 2019 16:16:34 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0H2pVMzDqXW for ; Fri, 31 May 2019 16:14:06 +1000 (AEST) Received: from pps.filterd (m0098419.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V655hQ135195 for ; Fri, 31 May 2019 02:14:02 -0400 Received: from e36.co.us.ibm.com (e36.co.us.ibm.com [32.97.110.154]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stv224n21-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:02 -0400 Received: from localhost by e36.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:01 +0100 Received: from b03cxnp07028.gho.boulder.ibm.com (9.17.130.15) by e36.co.us.ibm.com (192.168.1.136) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:00 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp07028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6DxJB11338142 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:13:59 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 518A56A04D for ; Fri, 31 May 2019 06:13:59 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 1A4D86A047 for ; Fri, 31 May 2019 06:13:59 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:13:59 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 5A17F4F107F; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:03 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0020-0000-0000-00000EF27377 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:01 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0021-0000-0000-000066081ECC Message-Id: <20190531061351.22973-3-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=682 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 002/110] doc/opal-spec: update email address X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith Reviewed-by: Andrew Donnellan --- doc/opal-spec.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/opal-spec.rst b/doc/opal-spec.rst index 5f3deca55741..929ed9c99491 100644 --- a/doc/opal-spec.rst +++ b/doc/opal-spec.rst @@ -16,7 +16,7 @@ implementation. It is not recommended that you do this though. Authors ------- -Stewart Smith : OPAL Architect, IBM +Stewart Smith : OPAL Architect, IBM Definitions From patchwork Fri May 31 06:12:04 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108053 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ1M6mjgz9sDX for ; Fri, 31 May 2019 16:15:03 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ1L6GqvzDqYC for ; Fri, 31 May 2019 16:15:02 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0H3QYKzDqY6 for ; Fri, 31 May 2019 16:14:07 +1000 (AEST) Received: from pps.filterd (m0098416.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V648NQ019162 for ; Fri, 31 May 2019 02:14:03 -0400 Received: from e33.co.us.ibm.com (e33.co.us.ibm.com [32.97.110.151]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stty1pnct-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:02 -0400 Received: from localhost by e33.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:02 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e33.co.us.ibm.com (192.168.1.133) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:00 +0100 Received: from b03ledav001.gho.boulder.ibm.com (b03ledav001.gho.boulder.ibm.com [9.17.130.232]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6Dxhg13893934 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:13:59 GMT Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 5B1396E04E for ; Fri, 31 May 2019 06:13:59 +0000 (GMT) Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 23C456E04C for ; Fri, 31 May 2019 06:13:59 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav001.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:13:59 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 5FE314F1106; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:04 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0036-0000-0000-00000AC5184C X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:00 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0037-0000-0000-00004C021464 Message-Id: <20190531061351.22973-4-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=695 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 003/110] doc/overview: flesh out overview X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith Reviewed-by: Andrew Donnellan --- doc/overview.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/doc/overview.rst b/doc/overview.rst index 63667013e447..3895f67f6edf 100644 --- a/doc/overview.rst +++ b/doc/overview.rst @@ -1,8 +1,10 @@ Skiboot overview ================ -Skiboot is firmware, loaded by the FSP. Along with loading the bootloader, -it provides some runtime services to the OS (typically Linux). +Skiboot is boot and runtime firmware for OpenPOWER systems. +It's loaded by earlier boot firmware (typically Hostboot). +Along with loading the bootloader, it provides some runtime +services to the OS (typically Linux). Source layout ------------- From patchwork Fri May 31 06:12:05 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108064 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ600MsPz9s00 for ; Fri, 31 May 2019 16:19:04 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ5z6chhzDqbX for ; Fri, 31 May 2019 16:19:03 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0H3z0HzDqYB for ; Fri, 31 May 2019 16:14:07 +1000 (AEST) Received: from pps.filterd (m0098416.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V643V0019014 for ; Fri, 31 May 2019 02:14:03 -0400 Received: from e11.ny.us.ibm.com (e11.ny.us.ibm.com [129.33.205.201]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stty1pnd2-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:03 -0400 Received: from localhost by e11.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:02 +0100 Received: from b01cxnp23034.gho.pok.ibm.com (9.57.198.29) by e11.ny.us.ibm.com (146.89.104.198) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:00 +0100 Received: from b01ledav004.gho.pok.ibm.com (b01ledav004.gho.pok.ibm.com [9.57.199.109]) by b01cxnp23034.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6DxWM34144562 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:00 GMT Received: from b01ledav004.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id CF758112065 for ; Fri, 31 May 2019 06:13:59 +0000 (GMT) Received: from b01ledav004.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 4C3AA112061 for ; Fri, 31 May 2019 06:13:59 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav004.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:13:59 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 66A6A4F1107; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:05 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-2213-0000-0000-0000039856AA X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:01 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-2214-0000-0000-00005EA4D930 Message-Id: <20190531061351.22973-5-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 004/110] doc: Giant OPAL API table X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Document when each OPAL API was introduced, and the base processor level where it can be assumed that the call exists (if hardware available and subject to per-call documentation). Fixes: https://github.com/open-power/skiboot/issues/131 Signed-off-by: Stewart Smith --- doc/opal-api/index.rst | 349 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 349 insertions(+) diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 52106f499a2f..5aa259d4ff1f 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -6,6 +6,355 @@ OPAL API Documentation The OPAL API is the interface between an Operating System and OPAL. ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| Name | API Token ID | Introduced | Required | Notes | +| | | | as of | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_TEST` | 0 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_CONSOLE_WRITE` | 1 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_CONSOLE_READ` | 2 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_RTC_READ` | 3 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_RTC_WRITE` | 4 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_CEC_POWER_DOWN` | 5 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_CEC_REBOOT` | 6 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_READ_NVRAM` | 7 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_WRITE_NVRAM` | 8 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_HANDLE_INTERRUPT` | 9 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_POLL_EVENTS` | 10 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SET_HUB_TCE_MEMORY` | 11 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SET_PHB_TCE_MEMORY` | 12 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_CONFIG_READ_BYTE` | 13 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_CONFIG_READ_HALF_WORD` | 14 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_CONFIG_READ_WORD` | 15 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_CONFIG_WRITE_BYTE` | 16 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_CONFIG_WRITE_HALF_WORD` | 17 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_CONFIG_WRITE_WORD` | 18 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_SET_XIVE` | 19 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_GET_XIVE` | 20 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_GET_COMPLETION_TOKEN_STATUS` | 21 | v1.0 (Initial Release) | POWER8 | /* obsolete */ | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_REGISTER_OPAL_EXCEPTION_HANDLER` | 22 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_EEH_FREEZE_STATUS` | 23 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SHPC` | 24 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_CONSOLE_WRITE_BUFFER_SPACE` | 25 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_EEH_FREEZE_CLEAR` | 26 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_PHB_MMIO_ENABLE` | 27 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SET_PHB_MEM_WINDOW` | 28 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_MAP_PE_MMIO_WINDOW` | 29 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SET_PHB_TABLE_MEMORY` | 30 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SET_PE` | 31 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SET_PELTV` | 32 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SET_MVE` | 33 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SET_MVE_ENABLE` | 34 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_GET_XIVE_REISSUE` | 35 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SET_XIVE_REISSUE` | 36 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SET_XIVE_PE` | 37 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_GET_XIVE_SOURCE` | 38 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_GET_MSI_32` | 39 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_GET_MSI_64` | 40 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_START_CPU` | 41 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_QUERY_CPU_STATUS` | 42 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_WRITE_OPPANEL` | 43 | v1.0 (Initial Release) | POWER8 | unimplemented | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_MAP_PE_DMA_WINDOW` | 44 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_MAP_PE_DMA_WINDOW_REAL` | 45 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_RESET` | 49 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_GET_HUB_DIAG_DATA` | 50 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_GET_PHB_DIAG_DATA` | 51 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_FENCE_PHB` | 52 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_REINIT` | 53 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_MASK_PE_ERROR` | 54 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_SET_SLOT_LED_STATUS` | 55 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_GET_EPOW_STATUS` | 56 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_SET_SYSTEM_ATTENTION_LED` | 57 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_RESERVED1` | 58 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_RESERVED2` | 59 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_NEXT_ERROR` | 60 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_EEH_FREEZE_STATUS2` | 61 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_POLL` | 62 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_MSI_EOI` | 63 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_GET_PHB_DIAG_DATA2` | 64 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XSCOM_READ` | 65 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XSCOM_WRITE` | 66 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_LPC_READ` | 67 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_LPC_WRITE` | 68 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_RETURN_CPU` | 69 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_REINIT_CPUS` | 70 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_ELOG_READ` | 71 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_ELOG_WRITE` | 72 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_ELOG_ACK` | 73 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_ELOG_RESEND` | 74 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_ELOG_SIZE` | 75 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_FLASH_VALIDATE` | 76 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_FLASH_MANAGE` | 77 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_FLASH_UPDATE` | 78 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_RESYNC_TIMEBASE` | 79 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_CHECK_TOKEN` | 80 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_DUMP_INIT` | 81 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_DUMP_INFO` | 82 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_DUMP_READ` | 83 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_DUMP_ACK` | 84 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_GET_MSG` | 85 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_CHECK_ASYNC_COMPLETION` | 86 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_SYNC_HOST_REBOOT` | 87 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_SENSOR_READ` | 88 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_GET_PARAM` | 89 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_SET_PARAM` | 90 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_DUMP_RESEND` | 91 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_ELOG_SEND` | 92 | v1.0 (Initial Release) | POWER8 | Deprecated | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SET_PHB_CAPI_MODE` | 93 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_DUMP_INFO2` | 94 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_WRITE_OPPANEL_ASYNC` | 95 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_ERR_INJECT` | 96 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_EEH_FREEZE_SET` | 97 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_HANDLE_HMI` | 98 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_CONFIG_CPU_IDLE_STATE` | 99 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_SLW_SET_REG` | 100 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_REGISTER_DUMP_REGION` | 101 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_UNREGISTER_DUMP_REGION` | 102 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_WRITE_TPO` | 103 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_READ_TPO` | 104 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_GET_DPO_STATUS` | 105 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_OLD_I2C_REQUEST` | 106 | Introduced and | | Do not use. | +| | | deprecated in v4.0. | | | +| | | Should be completely | | | +| | | unused. | | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_IPMI_SEND` | 107 | v4.0 | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_IPMI_RECV` | 108 | v4.0 | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_I2C_REQUEST` | 109 | v4.0 | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_FLASH_READ` | 110 | v5.0 | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_FLASH_WRITE` | 111 | v5.0 | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_FLASH_ERASE` | 112 | v5.0 | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PRD_MSG` | 113 | v5.0 | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_LEDS_GET_INDICATOR` | 114 | v5.0 | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_LEDS_SET_INDICATOR` | 115 | v5.0 | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_CEC_REBOOT2` | 116 | :ref:`skiboot-5.1.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_CONSOLE_FLUSH` | 117 | :ref:`skiboot-5.1.13` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_GET_DEVICE_TREE` | 118 | :ref:`skiboot-5.3.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_GET_PRESENCE_STATE` | 119 | :ref:`skiboot-5.3.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_GET_POWER_STATE` | 120 | :ref:`skiboot-5.3.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SET_POWER_STATE` | 121 | :ref:`skiboot-5.3.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_INT_GET_XIRR` | 122 | :ref:`skiboot-5.3.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_INT_SET_CPPR` | 123 | :ref:`skiboot-5.3.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_INT_EOI` | 124 | :ref:`skiboot-5.3.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_INT_SET_MFRR` | 125 | :ref:`skiboot-5.3.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_TCE_KILL` | 126 | :ref:`skiboot-5.3.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_NMMU_SET_PTCR` | 127 | :ref:`skiboot-5.4.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_RESET` | 128 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_GET_IRQ_INFO` | 129 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_GET_IRQ_CONFIG` | 130 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_SET_IRQ_CONFIG` | 131 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_GET_QUEUE_INFO` | 132 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_SET_QUEUE_INFO` | 133 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_DONATE_PAGE` | 134 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_ALLOCATE_VP_BLOCK` | 135 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_FREE_VP_BLOCK` | 136 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_GET_VP_INFO` | 137 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_SET_VP_INFO` | 138 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_ALLOCATE_IRQ` | 139 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_FREE_IRQ` | 140 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_SYNC` | 141 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_DUMP` | 142 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_GET_QUEUE_STATE` | 143 | :ref:`skiboot-6.3` | | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_SET_QUEUE_STATE` | 144 | :ref:`skiboot-6.3` | | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_SIGNAL_SYSTEM_RESET` | 145 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_NPU_INIT_CONTEXT` | 146 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_NPU_DESTROY_CONTEXT` | 147 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_NPU_MAP_LPAR` | 148 | :ref:`skiboot-5.5.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_IMC_COUNTERS_INIT` | 149 | :ref:`skiboot-5.7` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_IMC_COUNTERS_START` | 150 | :ref:`skiboot-5.7` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_IMC_COUNTERS_STOP` | 151 | :ref:`skiboot-5.7` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_GET_POWERCAP` | 152 | :ref:`skiboot-5.8` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_SET_POWERCAP` | 153 | :ref:`skiboot-5.8` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_GET_POWER_SHIFT_RATIO` | 154 | :ref:`skiboot-5.8` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_SET_POWER_SHIFT_RATIO` | 155 | :ref:`skiboot-5.8` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_SENSOR_GROUP_CLEAR` | 156 | :ref:`skiboot-5.8` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SET_P2P` | 157 | :ref:`skiboot-5.8` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_QUIESCE` | 158 | :ref:`skiboot-5.10` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_NPU_SPA_SETUP` | 159 | :ref:`skiboot-5.11` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_NPU_SPA_CLEAR_CACHE` | 160 | :ref:`skiboot-5.11` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_NPU_TL_SET` | 161 | :ref:`skiboot-5.11` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_SENSOR_READ_U64` | 162 | :ref:`skiboot-5.10` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_SENSOR_GROUP_ENABLE` | 163 | :ref:`skiboot-5.10` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_GET_PBCQ_TUNNEL_BAR` | 164 | :ref:`skiboot-5.11` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_PCI_SET_PBCQ_TUNNEL_BAR` | 165 | :ref:`skiboot-5.11` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_HANDLE_HMI2` | 166 | :ref:`skiboot-6.0` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_NX_COPROC_INIT` | 167 | :ref:`skiboot-6.1` | | | +| | | :ref:`skiboot-6.0.5` | | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_NPU_SET_RELAXED_ORDER` | 168 | :ref:`skiboot-6.2` | | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_NPU_GET_RELAXED_ORDER` | 169 | :ref:`skiboot-6.2` | | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_XIVE_GET_VP_STATE` | 170 | :ref:`skiboot-6.3` | | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_NPU_MEM_ALLOC` | 171 | Future, likely 6.4 | | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_NPU_MEM_RELEASE` | 172 | Future, likely 6.4 | | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ + .. toctree:: :maxdepth: 1 :glob: From patchwork Fri May 31 06:12:06 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108050 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ0c1jG2z9sB8 for ; Fri, 31 May 2019 16:14:24 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ0Z2xTmzDqYB for ; Fri, 31 May 2019 16:14:21 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0H33rXzDqXv for ; Fri, 31 May 2019 16:14:06 +1000 (AEST) Received: from pps.filterd (m0098419.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V655Ve135191 for ; Fri, 31 May 2019 02:14:04 -0400 Received: from e13.ny.us.ibm.com (e13.ny.us.ibm.com [129.33.205.203]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stv224n3x-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:04 -0400 Received: from localhost by e13.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:03 +0100 Received: from b01cxnp22033.gho.pok.ibm.com (9.57.198.23) by e13.ny.us.ibm.com (146.89.104.200) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:01 +0100 Received: from b01ledav001.gho.pok.ibm.com (b01ledav001.gho.pok.ibm.com [9.57.199.106]) by b01cxnp22033.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E1b539518386 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:01 GMT Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id F288628059 for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id AFF342805E for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav001.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 6BCB74F1109; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:06 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0064-0000-0000-000003E76F39 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:02 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0065-0000-0000-00003DAD78DB Message-Id: <20190531061351.22973-6-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=630 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 005/110] doc: Make OPAL_CONSOLE_* docs pretty X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-console-read-write-1-2.rst | 62 ++++++++++++-------- 1 file changed, 37 insertions(+), 25 deletions(-) diff --git a/doc/opal-api/opal-console-read-write-1-2.rst b/doc/opal-api/opal-console-read-write-1-2.rst index 6d6c0ff03b9c..60cd0a6dd06f 100644 --- a/doc/opal-api/opal-console-read-write-1-2.rst +++ b/doc/opal-api/opal-console-read-write-1-2.rst @@ -1,12 +1,20 @@ OPAL Console calls ================== -There are four OPAL calls relating to the OPAL console: :: - - #define OPAL_CONSOLE_WRITE 1 - #define OPAL_CONSOLE_READ 2 - #define OPAL_CONSOLE_WRITE_BUFFER_SPACE 25 - #define OPAL_CONSOLE_FLUSH 117 +There are four OPAL calls relating to the OPAL console: + ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| Name | API Token ID | Introduced | Required | Notes | +| | | | as of | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_CONSOLE_WRITE` | 1 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_CONSOLE_READ` | 2 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_CONSOLE_WRITE_BUFFER_SPACE` | 25 | v1.0 (Initial Release) | POWER8 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ +| :ref:`OPAL_CONSOLE_FLUSH` | 117 | :ref:`skiboot-5.1.13` | POWER9 | | ++---------------------------------------------+--------------+------------------------+----------+-----------------+ The OPAL console calls can support multiple consoles. Each console MUST be represented in the device tree. @@ -16,6 +24,8 @@ for it to simply be an in-memory buffer and only support writing. [TODO: details on device tree specs for console] +.. _OPAL_CONSOLE_WRITE: + OPAL_CONSOLE_WRITE ------------------ @@ -25,12 +35,12 @@ Parameters: :: int64_t *length, const uint8_t *buffer -Returns: :: +Returns: - OPAL_SUCCESS - OPAL_PARAMETER - invalid term_number - OPAL_CLOSED - console device closed - OPAL_BUSY_EVENT - unable to write any of buffer + - :ref:`OPAL_SUCCESS` + - :ref:`OPAL_PARAMETER` on invalid term_number + - :ref:`OPAL_CLOSED` if console device closed + - :ref:`OPAL_BUSY_EVENT` if unable to write any of buffer ``term_number`` is the terminal number as represented in the device tree. ``length`` is a pointer to the length of buffer. @@ -46,15 +56,17 @@ Parameters: :: int64_t term_number int64_t *length -Returns: :: +Returns: - OPAL_SUCCESS - OPAL_PARAMETER - invalid term_number + - :ref:`OPAL_SUCCESS` + - :ref:`OPAL_PARAMETER` on invalid term_number Returns the available buffer length for OPAL_CONSOLE_WRITE in ``length``. This call can be used to help work out if there is sufficient buffer space to write your full message to the console with OPAL_CONSOLE_WRITE. +.. _OPAL_CONSOLE_READ: + OPAL_CONSOLE_READ ----------------- @@ -64,13 +76,13 @@ Parameters: :: int64_t *length uint8_t *buffer -Returns: :: +Returns: - OPAL_SUCCESS - OPAL_PARAMETER - invalid term_number - OPAL_CLOSED + - :ref:`OPAL_SUCCESS` + - :ref:`OPAL_PARAMETER` on invalid term_number + - :ref:`OPAL_CLOSED` -Use OPAL_POLL_EVENTS for how to determine +Use :ref:`OPAL_POLL_EVENTS` for how to determine OPAL_CONSOLE_FLUSH ------------------ @@ -79,10 +91,10 @@ Parameters: :: int64_t term_number -Returns: :: +Returns: - OPAL_SUCCESS - OPAL_UNSUPPORTED - the console does not implement a flush call - OPAL_PARAMETER - invalid term_number - OPAL_PARTIAL - more to flush, call again - OPAL_BUSY - nothing was flushed this call + - :ref:`OPAL_SUCCESS` + - :ref:`OPAL_UNSUPPORTED` if the console does not implement a flush call + - :ref:`OPAL_PARAMETER` on invalid term_number + - :ref:`OPAL_PARTIAL` if more to flush, call again + - :ref:`OPAL_BUSY` if nothing was flushed this call From patchwork Fri May 31 06:12:07 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108058 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ3S0PNvz9sB8 for ; Fri, 31 May 2019 16:16:52 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ3R6g6xzDqXW for ; Fri, 31 May 2019 16:16:51 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0H3QSJzDqXw for ; Fri, 31 May 2019 16:14:06 +1000 (AEST) Received: from pps.filterd (m0098414.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V640Cd133837 for ; Fri, 31 May 2019 02:14:03 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stwdwjr01-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:03 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dmxP006006 for ; Fri, 31 May 2019 02:48:54 GMT Received: from b03cxnp07028.gho.boulder.ibm.com (b03cxnp07028.gho.boulder.ibm.com [9.17.130.15]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9ayk6-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:54 +0000 Received: from b03ledav001.gho.boulder.ibm.com (b03ledav001.gho.boulder.ibm.com [9.17.130.232]) by b03cxnp07028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E0JB64880778 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:01 GMT Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id D1A8A6E058 for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 9A3636E054 for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav001.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 70A0F4F110A; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:07 +1000 Message-Id: <20190531061351.22973-7-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 006/110] doc: Make OPAL_RTC_READ docs pretty X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-rtc-read-3.rst | 32 ++++++++++++++++++-------------- 1 file changed, 18 insertions(+), 14 deletions(-) diff --git a/doc/opal-api/opal-rtc-read-3.rst b/doc/opal-api/opal-rtc-read-3.rst index f56cb2c96c5a..e2d492f2e0bf 100644 --- a/doc/opal-api/opal-rtc-read-3.rst +++ b/doc/opal-api/opal-rtc-read-3.rst @@ -1,3 +1,5 @@ +.. _OPAL_RTC_READ: + OPAL_RTC_READ ============= @@ -24,15 +26,17 @@ Parameters Calling ------- -Since RTC calls can be pretty slow, OPAL_RTC_READ is likely to first return -OPAL_BUSY_EVENT, requiring the caller to wait until the OPAL_EVENT_RTC event +Since RTC calls can be pretty slow, :ref:`OPAL_RTC_READ` is likely to first return +:ref:`OPAL_BUSY_EVENT`, requiring the caller to wait until the :ref:`OPAL_EVENT_RTC` event has been signaled. Once the event has been signaled, a subsequent -OPAL_RTC_READ call will retrieve the time. Since the OPAL_EVENT_RTC event is +:ref:`OPAL_RTC_READ` call will retrieve the time. Since the :ref:`OPAL_EVENT_RTC` event is used for both reading and writing the RTC, callers must be able to handle -the event being signaled for a concurrent in flight OPAL_RTC_WRITE rather +the event being signaled for a concurrent in flight :ref:`OPAL_RTC_WRITE` rather than this read request. -The following code is one way to correctly issue and then wait for a response: :: +The following code is one way to correctly issue and then wait for a response: + +.. code-block:: c int rc = OPAL_BUSY_EVENT; while (rc == OPAL_BUSY_EVENT) { @@ -41,31 +45,31 @@ The following code is one way to correctly issue and then wait for a response: : opal_poll_events(NULL); } -Although as of writing all OPAL_RTC_READ backends are asynchronous, there is -no requirement for them to be - it is valid for OPAL_RTC_READ to immediately -return the retreived value rather than OPAL_BUSY_EVENT. +Although as of writing all :ref:`OPAL_RTC_READ` backends are asynchronous, there is +no requirement for them to be - it is valid for :ref:`OPAL_RTC_READ` to immediately +return the retreived value rather than :ref:`OPAL_BUSY_EVENT`. **TODO**: describe/document format of arguments. Return codes ------------ -OPAL_SUCCESS +:ref:`OPAL_SUCCESS` parameters now contain the current time, or one read from cache. -OPAL_HARDWARE +:ref:`OPAL_HARDWARE` error in retrieving the time. May be transient error, may be permanent. -OPAL_PARAMETER +:ref:`OPAL_PARAMETER` year_month_day or hour_minute_second_millisecond parameters are NULL -OPAL_INTERNAL_ERROR +:ref:`OPAL_INTERNAL_ERROR` something went wrong, Possibly reported in error log. This can be a transient error -OPAL_BUSY_EVENT +:ref:`OPAL_BUSY_EVENT` request is in flight -OPAL_BUSY +:ref:`OPAL_BUSY` request may be in flight From patchwork Fri May 31 06:12:08 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108059 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ3s07Bpz9sB8 for ; Fri, 31 May 2019 16:17:13 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ3r6CGWzDqYd for ; Fri, 31 May 2019 16:17:12 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0H3QT4zDqY1 for ; Fri, 31 May 2019 16:14:06 +1000 (AEST) Received: from pps.filterd (m0098414.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V642b4133889 for ; Fri, 31 May 2019 02:14:03 -0400 Received: from e34.co.us.ibm.com (e34.co.us.ibm.com [32.97.110.152]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stwdwjr02-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:03 -0400 Received: from localhost by e34.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:02 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e34.co.us.ibm.com (192.168.1.134) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:01 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E0jZ28770788 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:00 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id C7B04C605B for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 8F88AC6055 for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 751C84F110C; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:08 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0016-0000-0000-000009BC52A0 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:02 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0017-0000-0000-0000436E2D00 Message-Id: <20190531061351.22973-8-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=624 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 007/110] doc: make OPAL_RTC_WRITE docs pretty X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-rtc-write-4.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/doc/opal-api/opal-rtc-write-4.rst b/doc/opal-api/opal-rtc-write-4.rst index 3416b7912311..c5ef7503bef7 100644 --- a/doc/opal-api/opal-rtc-write-4.rst +++ b/doc/opal-api/opal-rtc-write-4.rst @@ -1,9 +1,11 @@ +.. _OPAL_RTC_WRITE: + OPAL_RTC_WRITE ============== -OPAL_RTC_WRITE is much like OPAL_RTC_READ in that it can be asynchronous. +:ref:`OPAL_RTC_WRITE` is much like :ref:`OPAL_RTC_READ` in that it can be asynchronous. If multiple WRITES are issued before the first one completes, subsequent writes are ignored. There can only be one write in flight at any one time. -Format of the time is the same as for OPAL_RTC_READ. +Format of the time is the same as for :ref:`OPAL_RTC_READ`. From patchwork Fri May 31 06:12:09 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108079 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZB6558Nz9s00 for ; Fri, 31 May 2019 16:22:38 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZB645chzDqX0 for ; Fri, 31 May 2019 16:22:38 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0K10lyzDqYX for ; Fri, 31 May 2019 16:14:08 +1000 (AEST) Received: from pps.filterd (m0098413.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V68H9g037277 for ; Fri, 31 May 2019 02:14:05 -0400 Received: from e12.ny.us.ibm.com (e12.ny.us.ibm.com [129.33.205.202]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxr105mv-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:05 -0400 Received: from localhost by e12.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:04 +0100 Received: from b01cxnp22035.gho.pok.ibm.com (9.57.198.25) by e12.ny.us.ibm.com (146.89.104.199) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:02 +0100 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp22035.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E1Ke33357996 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:01 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 06A22B205F for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B7A5BB2064 for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 796F74F110F; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:09 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0060-0000-0000-0000034A56DE X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:03 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0061-0000-0000-0000498FD369 Message-Id: <20190531061351.22973-9-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=560 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 008/110] doc: prettify OPAL_REINIT_CPUS X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-reinit-cpus-70.rst | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/doc/opal-api/opal-reinit-cpus-70.rst b/doc/opal-api/opal-reinit-cpus-70.rst index bee350d55f88..2522e76abe21 100644 --- a/doc/opal-api/opal-reinit-cpus-70.rst +++ b/doc/opal-api/opal-reinit-cpus-70.rst @@ -1,16 +1,23 @@ +.. _OPAL_REINIT_CPUS: + OPAL_REINIT_CPUS ================ -:: + +.. code-block:: c + + #define OPAL_REINIT_CPUS 70 static int64_t opal_reinit_cpus(uint64_t flags); This OPAL call reinitializes some bit of CPU state across *ALL* CPUs. Consequently, all CPUs must be in OPAL for this call to succeed (either -at boot time or after OPAL_RETURN_CPU is called) +at boot time or after OPAL_RETURN_CPU is called). Arguments --------- -Currently, possible flags are: :: +Currently, possible flags are: + +.. code-block:: c enum { OPAL_REINIT_CPUS_HILE_BE = (1 << 0), @@ -41,8 +48,7 @@ suspend mode disabled. This may only be supported on some CPU versions. Returns ------- -``OPAL_SUCCESS`` +:ref:`OPAL_SUCCESS` Success! - -``OPAL_UNSUPPORTED`` +:ref:`OPAL_UNSUPPORTED` Processor does not suport reinit flags. From patchwork Fri May 31 06:12:10 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108054 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ1v0GG1z9sB8 for ; Fri, 31 May 2019 16:15:31 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ1t6TtSzDqYS for ; Fri, 31 May 2019 16:15:30 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0H3QSgzDqY0 for ; Fri, 31 May 2019 16:14:06 +1000 (AEST) Received: from pps.filterd (m0098419.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V65D4e135720 for ; Fri, 31 May 2019 02:14:04 -0400 Received: from e34.co.us.ibm.com (e34.co.us.ibm.com [32.97.110.152]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stv224n3j-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:03 -0400 Received: from localhost by e34.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:02 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e34.co.us.ibm.com (192.168.1.134) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:02 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E1t127460038 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:01 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id EE26A6A04F for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B66936A05A for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 7DF814F1113; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:10 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0016-0000-0000-000009BC52A1 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:02 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0017-0000-0000-0000436E2D01 Message-Id: <20190531061351.22973-10-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=942 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 009/110] doc: prettify FSP Code update docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-code-update-76-77-78.rst | 33 ++++++++++++++++++++-- 1 file changed, 31 insertions(+), 2 deletions(-) diff --git a/doc/opal-api/opal-code-update-76-77-78.rst b/doc/opal-api/opal-code-update-76-77-78.rst index 91037d65ec1e..5a58d25205e1 100644 --- a/doc/opal-api/opal-code-update-76-77-78.rst +++ b/doc/opal-api/opal-code-update-76-77-78.rst @@ -1,15 +1,27 @@ Code Update on FSP based machine ================================ -There are three OPAL calls for code update on FSP based machine: :: +There are three OPAL calls for code update. These are currently only +implemented on FSP based machines. + +.. code-block::c #define OPAL_FLASH_VALIDATE 76 #define OPAL_FLASH_MANAGE 77 #define OPAL_FLASH_UPDATE 78 +.. _OPAL_FLASH_VALIDATE: + OPAL_FLASH_VALIDATE ------------------- +.. code-block:: c + + #define OPAL_FLASH_VALIDATE 76 + + int64_t fsp_opal_validate_flash(uint64_t buffer, uint32_t *size, uint32_t *result); + + Validate new image is valid for this platform or not. We do below validation in OPAL: @@ -48,9 +60,17 @@ Return value ^^^^^^^^^^^^ Validation status +.. _OPAL_FLASH_MANAGE: OPAL_FLASH_MANAGE ----------------- + +.. code-block:: c + + #define OPAL_FLASH_MANAGE 77 + + int64_t fsp_opal_manage_flash(uint8_t op); + Commit/Reject image. - We can commit new image (T -> P), if system is running with T side image. @@ -69,8 +89,17 @@ op Return value Commit operation status (0 : Success) +.. _OPAL_FLASH_UPDATE: + OPAL_FLASH_UPDATE ------------------- +----------------- + +.. code-block:: c + + #define OPAL_FLASH_UPDATE 78 + + int64_t fsp_opal_update_flash(struct opal_sg_list *list); + Update new image. It only sets the flag, actual update happens during system reboot/shutdown. From patchwork Fri May 31 06:12:11 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108061 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ4c6Jnmz9sB8 for ; Fri, 31 May 2019 16:17:52 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ4c4h1SzDqc6 for ; Fri, 31 May 2019 16:17:52 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0H2vSSzDqXX for ; Fri, 31 May 2019 16:14:06 +1000 (AEST) Received: from pps.filterd (m0098416.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V644T7019079 for ; Fri, 31 May 2019 02:14:03 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stty1pncu-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:02 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dmxO006006 for ; Fri, 31 May 2019 02:48:54 GMT Received: from b01cxnp22034.gho.pok.ibm.com (b01cxnp22034.gho.pok.ibm.com [9.57.198.24]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9ayk7-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:54 +0000 Received: from b01ledav002.gho.pok.ibm.com (b01ledav002.gho.pok.ibm.com [9.57.199.107]) by b01cxnp22034.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E15J30081252 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:01 GMT Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 3EE13124054 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id E6282124058 for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav002.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 82AD54F111E; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:11 +1000 Message-Id: <20190531061351.22973-11-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 010/110] doc: prettify and expand OPAL_HANDLE_HMI2 docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-handle-hmi-98-166.rst | 187 +++++++++++++----------- doc/opal-api/opal-messages.rst | 2 + 2 files changed, 106 insertions(+), 83 deletions(-) diff --git a/doc/opal-api/opal-handle-hmi-98-166.rst b/doc/opal-api/opal-handle-hmi-98-166.rst index 950e0c4ef7fa..5959e5e90194 100644 --- a/doc/opal-api/opal-handle-hmi-98-166.rst +++ b/doc/opal-api/opal-handle-hmi-98-166.rst @@ -1,34 +1,34 @@ Hypervisor Maintenance Interrupt (HMI) ====================================== - Hypervisor Maintenance Interrupt usually reports error related to processor - recovery/checkstop, NX/NPU checkstop and Timer facility. Hypervisor then - takes this opportunity to analyze and recover from some of these errors. - Hypervisor takes assistance from OPAL layer to handle and recover from HMI. - After handling HMI, OPAL layer sends the summary of error report and status - of recovery action using HMI event. See ref: `opal-messages.rst` for HMI - event structure under ```OPAL_MSG_HMI_EVT``` section. - - HMI is thread specific. The reason for HMI is available in a per thread - Hypervisor Maintenance Exception Register (HMER). A Hypervisor Maintenance - Exception Enable Register (HMEER) is per core. Bits from the HMER need to - be enabled by the corresponding bits in the HMEER in order to cause an HMI. - - Several interrupt reasons are routed in parallel to each of the thread - specific copies. Each thread can only clear bits in its own HMER. OPAL - handler from each thread clears the respective bit from HMER register - after handling the error. +Hypervisor Maintenance Interrupt usually reports error related to processor +recovery/checkstop, NX/NPU checkstop and Timer facility. Hypervisor then +takes this opportunity to analyze and recover from some of these errors. +Hypervisor takes assistance from OPAL layer to handle and recover from HMI. +After handling HMI, OPAL layer sends the summary of error report and status +of recovery action using HMI event. See ref:`opal-messages` for HMI +event structure under :ref:`OPAL_MSG_HMI_EVT` section. + +HMI is thread specific. The reason for HMI is available in a per thread +Hypervisor Maintenance Exception Register (HMER). A Hypervisor Maintenance +Exception Enable Register (HMEER) is per core. Bits from the HMER need to +be enabled by the corresponding bits in the HMEER in order to cause an HMI. + +Several interrupt reasons are routed in parallel to each of the thread +specific copies. Each thread can only clear bits in its own HMER. OPAL +handler from each thread clears the respective bit from HMER register +after handling the error. List of errors that causes HMI ============================== - - CPU Errors + - CPU Errors - Processor Core checkstop - Processor retry recovery - NX/NPU/CAPP checkstop. - - Timer facility Errors + - Timer facility Errors - ChipTOD Errors @@ -36,7 +36,7 @@ List of errors that causes HMI - ChipTOD configuration register parity errors - ChiTOD topology failover - - Timebase (TB) errors + - Timebase (TB) errors - TB parity/residue error - TFMR parity and firmware control error @@ -45,84 +45,95 @@ List of errors that causes HMI HMI handling ============ - A core/NX/NPU checkstops are reported as malfunction alert (HMER bit 0). - OPAL handler scans through Fault Isolation Register (FIR) for each - core/nx/npu to detect the exact reason for checkstop and reports it back - to the host alongwith the disposition. - - A processor recovery is reported through HMER bits 2, 3 and 11. These are - just an informational messages and no extra recovery is required. - - Timer facility errors are reported through HMER bit 4. These are all - recoverable errors. The exact reason for the errors are stored in - Timer Facility Management Register (TFMR). Some of the Timer facility - errors affects TB and some of them affects TOD. TOD is a per chip - Time-Of-Day logic that holds the actual time value of the chip and - communicates with every TOD in the system to achieve synchronized - timer value within a system. TB is per core register (64-bit) derives its - value from ChipTOD at startup and then it gets periodically incremented - by STEP signal provided by the TOD. In a multi-socket system TODs are - always configured as master/backup TOD under primary/secondary - topology configuration respectively. - - TB error generates HMI on all threads of the affected core. TB errors - except DEC/HDEC/PURR/SPURR parity errors, causes TB to stop running - making it invalid. As part of TB recovery, OPAL hmi handler synchronizes - with all threads, clears the TB errors and then re-sync the TB with TOD - value putting it back in running state. - - TOD errors generates HMI on every core/thread of affected chip. The reason - for TOD errors are stored in TOD ERROR register (0x40030). As part of the - recovery OPAL hmi handler clears the TOD error and then requests new TOD - value from another running chipTOD in the system. Sometimes, if a primary - chipTOD is in error, it may need a TOD topology switch to recover from - error. A TOD topology switch basically makes a backup as new active master. - -OPAL_HANDLE_HMI and OPAL_HANDLE_HMI2 -==================================== -:: +A core/NX/NPU checkstops are reported as malfunction alert (HMER bit 0). +OPAL handler scans through Fault Isolation Register (FIR) for each +core/nx/npu to detect the exact reason for checkstop and reports it back +to the host alongwith the disposition. + +A processor recovery is reported through HMER bits 2, 3 and 11. These are +just an informational messages and no extra recovery is required. + +Timer facility errors are reported through HMER bit 4. These are all +recoverable errors. The exact reason for the errors are stored in +Timer Facility Management Register (TFMR). Some of the Timer facility +errors affects TB and some of them affects TOD. TOD is a per chip +Time-Of-Day logic that holds the actual time value of the chip and +communicates with every TOD in the system to achieve synchronized +timer value within a system. TB is per core register (64-bit) derives its +value from ChipTOD at startup and then it gets periodically incremented +by STEP signal provided by the TOD. In a multi-socket system TODs are +always configured as master/backup TOD under primary/secondary +topology configuration respectively. + +TB error generates HMI on all threads of the affected core. TB errors +except DEC/HDEC/PURR/SPURR parity errors, causes TB to stop running +making it invalid. As part of TB recovery, OPAL hmi handler synchronizes +with all threads, clears the TB errors and then re-sync the TB with TOD +value putting it back in running state. + +TOD errors generates HMI on every core/thread of affected chip. The reason +for TOD errors are stored in TOD ERROR register (0x40030). As part of the +recovery OPAL hmi handler clears the TOD error and then requests new TOD +value from another running chipTOD in the system. Sometimes, if a primary +chipTOD is in error, it may need a TOD topology switch to recover from +error. A TOD topology switch basically makes a backup as new active master. + +.. _OPAL_HANDLE_HMI: + +OPAL_HANDLE_HMI +=============== + +.. code-block:: c #define OPAL_HANDLE_HMI 98 - #define OPAL_HANDLE_HMI2 166 -``OPAL_HANDLE_HMI`` + int64_t opal_handle_hmi(void); -``OPAL_HANDLE_HMI2`` - When OS host gets an Hypervisor Maintenance Interrupt (HMI), it must call - ```OPAL_HANDLE_HMI``` or ```OPAL_HANDLE_HMI2```. The ```OPAL_HANDLE_HMI``` - is an old interface. ```OPAL_HANDLE_HMI2``` is newly introduced opal call - that returns direct info to Linux. It returns a 64-bit flag mask currently - set to provide info about which timer facilities were lost, and whether an - event was generated. This information will help OS to take respective - actions. - In case where opal hmi handler is unable to recover from TOD or TB errors, - it would flag ```OPAL_HMI_FLAGS_TOD_TB_FAIL``` to indicate OS that TB is - dead. This information then can be used by OS to make sure that the - functions relying on TB value (e.g. udelay()) are aware of TB not ticking. - This will avoid OS getting stuck or hang during its way to panic path. +Superseded by :ref:`OPAL_HANDLE_HMI2`, meaning that :ref:`OPAL_HANDLE_HMI` +should only be called if :ref:`OPAL_HANDLE_HMI2` is not available. -OPAL_HANDLE_HMI ---------------- -Syntax: :: +Since :ref:`OPAL_HANDLE_HMI2` has been available since the start of POWER9 +systems being supported, if you only target POWER9 and above, you can +assume the presence of :ref:`OPAL_HANDLE_HMI2`. - int64_t opal_handle_hmi(void) +.. _OPAL_HANDLE_HMI2: OPAL_HANDLE_HMI2 ----------------- -Syntax: :: +================ + +.. code-block:: c + + #define OPAL_HANDLE_HMI2 166 + + int64_t opal_handle_hmi2(__be64 *out_flags); + +When OS host gets an Hypervisor Maintenance Interrupt (HMI), it must call +:ref:`OPAL_HANDLE_HMI` or :ref:`OPAL_HANDLE_HMI2`. The :ref:`OPAL_HANDLE_HMI` +is an old interface. :ref:`OPAL_HANDLE_HMI2` is newly introduced opal call +that returns direct info to the OS. It returns a 64-bit flag mask currently +set to provide info about which timer facilities were lost, and whether an +event was generated. This information will help OS to take respective +actions. + +In case where opal hmi handler is unable to recover from TOD or TB errors, +it would flag :ref:`OPAL_HMI_FLAGS_TOD_TB_FAIL` to indicate OS that TB is +dead. This information then can be used by OS to make sure that the +functions relying on TB value (e.g. udelay()) are aware of TB not ticking. +This will avoid OS getting stuck or hang during its way to panic path. - int64_t opal_handle_hmi2(__be64 *out_flags) -parameters +Parameters ^^^^^^^^^^ - ``__be64 *out_flags`` +.. code-block:: c - Returns the 64-bit flag mask that provides info about which timer facilities - were lost, and whether an event was generated. + __be64 *out_flags; -:: +Returns the 64-bit flag mask that provides info about which timer facilities +were lost, and whether an event was generated. + +.. code-block:: c /* OPAL_HANDLE_HMI2 out_flags */ enum { @@ -132,3 +143,13 @@ parameters OPAL_HMI_FLAGS_TOD_TB_FAIL = (1ull << 3), /* TOD/TB recovery failed. */ OPAL_HMI_FLAGS_NEW_EVENT = (1ull << 63), /* An event has been created */ }; + +.. _OPAL_HMI_FLAGS_TOD_TB_FAIL: + +OPAL_HMI_FLAGS_TOD_TB_FAIL + The Time of Day (TOD) / Timebase facility has failed. This is probably fatal + for the OS, and requires the OS to be very careful to not call any function + that may rely on it, usually as it heads down a `panic()` code path. + This code path should be :ref:`OPAL_CEC_REBOOT2` with the OPAL_REBOOT_PLATFORM_ERROR + option. Details of the failure are likely delivered as part of HMI events if + `OPAL_HMI_FLAGS_NEW_EVENT` is set. diff --git a/doc/opal-api/opal-messages.rst b/doc/opal-api/opal-messages.rst index e4e813aadb3b..b023622d2d26 100644 --- a/doc/opal-api/opal-messages.rst +++ b/doc/opal-api/opal-messages.rst @@ -65,6 +65,8 @@ or a reboot. :: params[0] = 0x01 reboot, 0x00 shutdown +.. _OPAL_MSG_HMI_EVT: + OPAL_MSG_HMI_EVT ---------------- From patchwork Fri May 31 06:12:12 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108052 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ0z6BKLz9sB8 for ; Fri, 31 May 2019 16:14:43 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ0z4vTNzDqXt for ; Fri, 31 May 2019 16:14:43 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0H3QVfzDqY2 for ; Fri, 31 May 2019 16:14:07 +1000 (AEST) Received: from pps.filterd (m0098413.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V68ZZ6037828 for ; Fri, 31 May 2019 02:14:03 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxr105kk-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:03 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dnPB006009 for ; Fri, 31 May 2019 02:48:54 GMT Received: from b03cxnp08026.gho.boulder.ibm.com (b03cxnp08026.gho.boulder.ibm.com [9.17.130.18]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9ayk8-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:54 +0000 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp08026.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E11R25690492 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:01 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 34A8EC6059 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id F1399C6061 for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 86CCF4E6BE7; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:12 +1000 Message-Id: <20190531061351.22973-12-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 011/110] doc: prettify OPAL powercap docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- .../ibm,opal/power-mgt/powercap.rst | 4 +- doc/opal-api/opal-powercap.rst | 60 ++++++++++--------- 2 files changed, 35 insertions(+), 29 deletions(-) diff --git a/doc/device-tree/ibm,opal/power-mgt/powercap.rst b/doc/device-tree/ibm,opal/power-mgt/powercap.rst index 5d24ee15a0ed..e59f6c28354b 100644 --- a/doc/device-tree/ibm,opal/power-mgt/powercap.rst +++ b/doc/device-tree/ibm,opal/power-mgt/powercap.rst @@ -1,3 +1,5 @@ +.. _device-tree/ibm,opal/power-mgt/powercap: + power-mgt/powercap ------------------ @@ -8,7 +10,7 @@ For example : :: system-powercap/ -The OPAL_GET_POWERCAP and OPAL_SET_POWERCAP calls take a handle for +The :ref:`OPAL_GET_POWERCAP` and :ref:`OPAL_SET_POWERCAP` calls take a handle for what powercap property to get/set which is defined in the child node. The compatible property for the linux driver which will be diff --git a/doc/opal-api/opal-powercap.rst b/doc/opal-api/opal-powercap.rst index a49d7e7df23b..6ff4d5cca87d 100644 --- a/doc/opal-api/opal-powercap.rst +++ b/doc/opal-api/opal-powercap.rst @@ -1,7 +1,20 @@ .. _opal-powercap: +=============== +OPAL Power Caps +=============== + +Each entity that can be power capped is described in the device tree, +see :ref:`device-tree/ibm,opal/power-mgt/powercap`. The values for each +power cap aren't in the device tree, but rather fetched using the +:ref:`OPAL_GET_POWERCAP` OPAL call. This is because there may be other +entities such as a service processor that can change the nature of the +power cap asynchronously to OPAL. + +.. _OPAL_GET_POWERCAP: + OPAL_GET_POWERCAP -================== +================= The OPAL_GET_POWERCAP call retreives current information on the power cap. @@ -30,24 +43,22 @@ u32 \*pcap Returns ------- -OPAL_SUCCESS +:ref:`OPAL_SUCCESS` Success - -OPAL_PARAMETER +:ref:`OPAL_PARAMETER` Invalid pcap pointer - -OPAL_UNSUPPORTED +:ref:`OPAL_UNSUPPORTED` No support for reading powercap sensor - -OPAL_HARDWARE +:ref:`OPAL_HARDWARE` Unable to procced due to the current hardware state - -OPAL_ASYNC_COMPLETION +:ref:`OPAL_ASYNC_COMPLETION` Request was sent and an async completion message will be sent with token and status of the request. +.. _OPAL_SET_POWERCAP: + OPAL_SET_POWERCAP -============================ +================= The OPAL_SET_POWERCAP call sets a power cap. For each entity that can be power capped, the device tree @@ -71,30 +82,23 @@ Parameters Returns ------- -OPAL_SUCCESS - Success -OPAL_PARAMETER +:ref:`OPAL_SUCCESS` + Success +:ref:`OPAL_PARAMETER` Invalid powercap requested beyond powercap limits - -OPAL_UNSUPPORTED +:ref:`OPAL_UNSUPPORTED` No support for changing the powercap - -OPAL_PERMISSION +:ref:`OPAL_PERMISSION` Hardware cannot take the request - -OPAL_ASYNC_COMPLETION +:ref:`OPAL_ASYNC_COMPLETION` Request was sent and an async completion message will be sent with token and status of the request. - -OPAL_HARDWARE +:ref:`OPAL_HARDWARE` Unable to procced due to the current hardware state - -OPAL_BUSY +:ref:`OPAL_BUSY` Previous request in progress - -OPAL_INTERNAL_ERROR +:ref:`OPAL_INTERNAL_ERROR` Error in request response - -OPAL_TIMEOUT +:ref:`OPAL_TIMEOUT` Timeout in request completion From patchwork Fri May 31 06:12:13 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108070 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ845hF9z9s00 for ; Fri, 31 May 2019 16:20:52 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ844r4JzDqWb for ; Fri, 31 May 2019 16:20:52 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0J5NwKzDqY6 for ; Fri, 31 May 2019 16:14:08 +1000 (AEST) Received: from pps.filterd (m0098417.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V669dd145241 for ; Fri, 31 May 2019 02:14:05 -0400 Received: from e35.co.us.ibm.com (e35.co.us.ibm.com [32.97.110.153]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvp63uyf-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:04 -0400 Received: from localhost by e35.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:03 +0100 Received: from b03cxnp07029.gho.boulder.ibm.com (9.17.130.16) by e35.co.us.ibm.com (192.168.1.135) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:02 +0100 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp07029.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E1nS5112194 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:01 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 3D024BE04F for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 0526DBE05A for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:00 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 8B9174F2554; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:13 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0012-0000-0000-0000173DDCF7 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:03 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0013-0000-0000-00005778F800 Message-Id: <20190531061351.22973-13-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 012/110] doc: prettify opal IMC counters calls X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-imc-counters.rst | 32 ++++++++++++++---------------- 1 file changed, 15 insertions(+), 17 deletions(-) diff --git a/doc/opal-api/opal-imc-counters.rst b/doc/opal-api/opal-imc-counters.rst index ee06d7065cf4..85ade3f5aef5 100644 --- a/doc/opal-api/opal-imc-counters.rst +++ b/doc/opal-api/opal-imc-counters.rst @@ -1,7 +1,9 @@ .. _opal-imc-counters: +.. _OPAL_IMC_COUNTERS_INIT: + OPAL_IMC_COUNTERS_INIT -============================== +====================== OPAL call interface to initialize In-memory collection infrastructure. Call does multiple scom writes on each invocation for Core/Trace IMC initialization. And for the @@ -37,18 +39,17 @@ Parameters Returns ------- -OPAL_PARAMETER +:ref:`OPAL_PARAMETER` In case of unsupported ``type`` - -OPAL_HARDWARE +:ref:`OPAL_HARDWARE` If any error in setting up the hardware. - -OPAL_SUCCESS +:ref:`OPAL_SUCCESS` On succesfully initialized or even if init operation is a no-op. +.. _OPAL_IMC_COUNTERS_START: OPAL_IMC_COUNTERS_START -============================ +======================= OPAL call interface for starting the In-Memory Collection counters for a specified domain (NEST/CORE/TRACE). @@ -65,15 +66,14 @@ Parameters Returns ------- -OPAL_PARAMETER +:ref:`OPAL_PARAMETER` In case of Unsupported ``type`` - -OPAL_HARDWARE +:ref:`OPAL_HARDWARE` If any error in setting up the hardware. - -OPAL_SUCCESS +:ref:`OPAL_SUCCESS` On successful execution of the operation for the given ``type``. +.. _OPAL_IMC_COUNTERS_STOP: OPAL_IMC_COUNTERS_STOP ====================== @@ -96,11 +96,9 @@ Parameters Returns ------- -OPAL_PARAMETER +:ref:`OPAL_PARAMETER` In case of Unsupported ``type`` - -OPAL_HARDWARE +:ref:`OPAL_HARDWARE` If any error in setting up the hardware. - -OPAL_SUCCESS +:ref:`OPAL_SUCCESS` On successful execution of the operation for the given ``type``. From patchwork Fri May 31 06:12:14 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108063 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ5S6qnSz9sDX for ; Fri, 31 May 2019 16:18:36 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ5S5t21zDqWW for ; Fri, 31 May 2019 16:18:36 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0H5WDHzDqYL for ; Fri, 31 May 2019 16:14:07 +1000 (AEST) Received: from pps.filterd (m0098419.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V65I4l135821 for ; Fri, 31 May 2019 02:14:05 -0400 Received: from e33.co.us.ibm.com (e33.co.us.ibm.com [32.97.110.151]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stv224n49-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:04 -0400 Received: from localhost by e33.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:04 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e33.co.us.ibm.com (192.168.1.133) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:02 +0100 Received: from b03ledav002.gho.boulder.ibm.com (b03ledav002.gho.boulder.ibm.com [9.17.130.233]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E19Y23920998 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:01 GMT Received: from b03ledav002.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 577E4136053 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from b03ledav002.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 202C1136051 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav002.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 8FFF74E09EB; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:14 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0036-0000-0000-00000AC5184D X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:02 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0037-0000-0000-00004C02146F Message-Id: <20190531061351.22973-14-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=937 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 013/110] doc: prettify OPAL_SENSOR_GROUP_ENABLE and OPAL_SENSOR_GROUP_CLEAR X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-sensor-group-clear-156.rst | 40 ++++++++---------- doc/opal-api/opal-sensor-group-enable-163.rst | 41 ++++++++----------- 2 files changed, 36 insertions(+), 45 deletions(-) diff --git a/doc/opal-api/opal-sensor-group-clear-156.rst b/doc/opal-api/opal-sensor-group-clear-156.rst index cf874af7b49d..1a51c84e7716 100644 --- a/doc/opal-api/opal-sensor-group-clear-156.rst +++ b/doc/opal-api/opal-sensor-group-clear-156.rst @@ -1,42 +1,38 @@ -.. _opal-sensor-groups-clear: +.. _OPAL_SENSOR_GROUP_CLEAR: OPAL_SENSOR_GROUP_CLEAR -============================== +======================= + +.. code-block:: c + + int opal_sensor_group_clear(u32 group_hndl, int token); + + #define OPAL_SENSOR_GROUP_CLEAR 156 + OPAL call to clear the sensor groups data using a handle to identify the type of sensor group which is exported via DT. The call can be asynchronus, where the token parameter is used to wait for the completion. -Parameters ----------- -:: - u32 handle - int token Returns ------- -OPAL_SUCCESS - Success -OPAL_UNSUPPORTED +:ref:`OPAL_SUCCESS` + Success +:ref:`OPAL_UNSUPPORTED` No support for clearing the sensor group - -OPAL_HARDWARE +:ref:`OPAL_HARDWARE` Unable to procced due to the current hardware state - -OPAL_PERMISSION +:ref:`OPAL_PERMISSION` Hardware cannot take the request - -OPAL_ASYNC_COMPLETION +:ref:`OPAL_ASYNC_COMPLETION` Request was sent and an async completion message will be sent with token and status of the request. - -OPAL_BUSY +:ref:`OPAL_BUSY` Previous request in progress - -OPAL_INTERNAL_ERROR +:ref:`OPAL_INTERNAL_ERROR` Error in request response - -OPAL_TIMEOUT +:ref:`OPAL_TIMEOUT` Timeout in request completion diff --git a/doc/opal-api/opal-sensor-group-enable-163.rst b/doc/opal-api/opal-sensor-group-enable-163.rst index b702dd5f01cb..222a20239a10 100644 --- a/doc/opal-api/opal-sensor-group-enable-163.rst +++ b/doc/opal-api/opal-sensor-group-enable-163.rst @@ -1,7 +1,14 @@ -.. _opal-sensor-groups-enable: +.. _OPAL_SENSOR_GROUP_ENABLE: OPAL_SENSOR_GROUP_ENABLE -========================== +======================== + +.. code-block:: c + + #define OPAL_SENSOR_GROUP_ENABLE 163 + + int opal_sensor_group_enable(u32 group_hndl, int token, bool enable); + OPAL call to enable/disable the sensor group using a handle to identify the type of sensor group provided in the device tree. @@ -11,36 +18,24 @@ group by OCC to main memory. The call can be asynchronus, where the token parameter is used to wait for the completion. -Parameters ----------- -:: - u32 handle - int token - bool enable Returns ------- -OPAL_SUCCESS - Success -OPAL_UNSUPPORTED +:ref:`OPAL_SUCCESS` + Success +:ref:`OPAL_UNSUPPORTED` No support to enable/disable the sensor group - -OPAL_HARDWARE +:ref:`OPAL_HARDWARE` Unable to procced due to the current hardware state - -OPAL_PERMISSION +:ref:`OPAL_PERMISSION` Hardware cannot take the request - -OPAL_ASYNC_COMPLETION +:ref:`OPAL_ASYNC_COMPLETION` Request was sent and an async completion message will be sent with token and status of the request. - -OPAL_BUSY +:ref:`OPAL_BUSY` Previous request in progress - -OPAL_INTERNAL_ERROR +:ref:`OPAL_INTERNAL_ERROR` Error in request response - -OPAL_TIMEOUT +:ref:`OPAL_TIMEOUT` Timeout in request completion From patchwork Fri May 31 06:12:15 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108060 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ4F0WwJz9sB8 for ; Fri, 31 May 2019 16:17:33 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ4D6S5NzDqZw for ; Fri, 31 May 2019 16:17:32 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0H4yKDzDqYC for ; Fri, 31 May 2019 16:14:07 +1000 (AEST) Received: from pps.filterd (m0098419.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V655hS135195 for ; Fri, 31 May 2019 02:14:04 -0400 Received: from e36.co.us.ibm.com (e36.co.us.ibm.com [32.97.110.154]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stv224n44-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:04 -0400 Received: from localhost by e36.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:03 +0100 Received: from b03cxnp08026.gho.boulder.ibm.com (9.17.130.18) by e36.co.us.ibm.com (192.168.1.136) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:02 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp08026.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E1Ac19792180 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:01 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 51B48C6055 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 187D5C605B for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 953264E03A6; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:15 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0020-0000-0000-00000EF27378 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:03 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0021-0000-0000-000066081ECE Message-Id: <20190531061351.22973-15-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 014/110] doc: prettify OPAL_QUIESCE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-quiesce-158.rst | 87 ++++++++++++++++++------------- 1 file changed, 50 insertions(+), 37 deletions(-) diff --git a/doc/opal-api/opal-quiesce-158.rst b/doc/opal-api/opal-quiesce-158.rst index 19604396b541..babbe04131e4 100644 --- a/doc/opal-api/opal-quiesce-158.rst +++ b/doc/opal-api/opal-quiesce-158.rst @@ -1,58 +1,71 @@ -.. _opal-quiesce: +.. _OPAL_QUIESCE: OPAL_QUIESCE ============ -The host OS can use OPAL_QUIESCE to ensure CPUs under host control are not +.. code-block:: c + + #define OPAL_QUIESCE 158 + + int64_t opal_quiesce(uint32_t quiesce_type, int32_t cpu_target); + +The host OS can use :ref:`OPAL_QUIESCE` to ensure CPUs under host control are not executing OPAL. This is useful in crash or shutdown scenarios to try to ensure that CPUs are not holding locks, and is intended to be used with -OPAL_SIGNAL_SYSTEM_RESET, for example. +:ref:`OPAL_SIGNAL_SYSTEM_RESET`, for example. Arguments --------- -:: - - uint32_t quiesce_type - QUIESCE_HOLD Wait for all target(s) currently executing OPAL to - return to the host. Any new OPAL call that is made - will be held off until QUIESCE_RESUME. - QUIESCE_REJECT Wait for all target(s) currently executing OPAL to - return to the host. Any new OPAL call that is made - will fail with OPAL_BUSY until QUIESCE_RESUME. - QUIESCE_LOCK_BREAK After QUIESCE_HOLD or QUIESCE_REJECT is successful, - the CPU can call QUIESCE_LOCK_BREAK to skip all - locking in OPAL to give the best chance of making - progress in the crash/debug paths. The host should - ensure all other CPUs are stopped (e.g., with - OPAL_SIGNAL_SYSTEM_RESET) before this call is made, to - avoid concurrency. - QUIESCE_RESUME Undo the effects of QUIESCE_HOLD/QUIESCE_REJECT and - QUIESCE_LOCK_BREAK calls. - QUIESCE_RESUME_FAST_REBOOT - As above, but also reset the tracking of OS calls - into firmware as part of fast reboot (secondaries - will never return to OS, but instead be released - into a new OS boot). - - int32_t target_cpu - cpu_nr >= 0 The cpu server number of the target cpu to reset. - -1 All cpus except the current one should be quiesced. + +quiesce_type +^^^^^^^^^^^^ + +QUIESCE_HOLD + Wait for all target(s) currently executing OPAL to + return to the host. Any new OPAL call that is made + will be held off until QUIESCE_RESUME. +QUIESCE_REJECT + Wait for all target(s) currently executing OPAL to + return to the host. Any new OPAL call that is made + will fail with OPAL_BUSY until QUIESCE_RESUME. +QUIESCE_LOCK_BREAK + After QUIESCE_HOLD or QUIESCE_REJECT is successful, + the CPU can call QUIESCE_LOCK_BREAK to skip all + locking in OPAL to give the best chance of making + progress in the crash/debug paths. The host should + ensure all other CPUs are stopped (e.g., with + OPAL_SIGNAL_SYSTEM_RESET) before this call is made, to + avoid concurrency. +QUIESCE_RESUME + Undo the effects of QUIESCE_HOLD/QUIESCE_REJECT and + QUIESCE_LOCK_BREAK calls. +QUIESCE_RESUME_FAST_REBOOT + As above, but also reset the tracking of OS calls + into firmware as part of fast reboot (secondaries + will never return to OS, but instead be released + into a new OS boot). + +target_cpu +^^^^^^^^^^ + +``cpu_nr >= 0`` + The cpu server number of the target cpu to reset. +``-1`` + All cpus except the current one should be quiesced. Returns ------- -OPAL_SUCCESS - The quiesce call was successful. -OPAL_PARTIAL +:ref:`OPAL_SUCCESS` + The quiesce call was successful. +:ref:`OPAL_PARTIAL` Some or all of the CPUs executing OPAL when the call was made did not return to the host after a timeout of 1 second. This is a best effort at quiescing OPAL, and QUIESCE_RESUME must be called to resume normal firmware operation. - -OPAL_PARAMETER +:ref:`OPAL_PARAMETER` A parameter was incorrect. - -OPAL_BUSY +:ref:`OPAL_BUSY` This CPU was not able to complete the operation, either because another has concurrently started quiescing the system, or because it has not successfully called QUIESCE_HOLD or QUIESCE_REJECT before attempting From patchwork Fri May 31 06:12:16 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108073 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ8k75Qtz9s00 for ; Fri, 31 May 2019 16:21:26 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ8k62WYzDqYB for ; Fri, 31 May 2019 16:21:26 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0K0MP9zDqXW for ; Fri, 31 May 2019 16:14:08 +1000 (AEST) Received: from pps.filterd (m0098393.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V649M5075895 for ; Fri, 31 May 2019 02:14:05 -0400 Received: from e32.co.us.ibm.com (e32.co.us.ibm.com [32.97.110.150]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvha4a3t-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:05 -0400 Received: from localhost by e32.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:05 +0100 Received: from b03cxnp08026.gho.boulder.ibm.com (9.17.130.18) by e32.co.us.ibm.com (192.168.1.132) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:02 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp08026.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E1Xh19005762 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id DA4F0C6061 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id A36DFC6057 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 99ECE4E03AD; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:16 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0004-0000-0000-0000151674F4 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:03 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0005-0000-0000-00008BDE979A Message-Id: <20190531061351.22973-16-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=982 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 015/110] doc: prettify OPAL_PCI_SET_P2P X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-set-p2p-157.rst | 22 ++++++++-------------- 1 file changed, 8 insertions(+), 14 deletions(-) diff --git a/doc/opal-api/opal-pci-set-p2p-157.rst b/doc/opal-api/opal-pci-set-p2p-157.rst index c34630cc8ef0..d7be1147541b 100644 --- a/doc/opal-api/opal-pci-set-p2p-157.rst +++ b/doc/opal-api/opal-pci-set-p2p-157.rst @@ -1,11 +1,14 @@ +.. _OPAL_PCI_SET_P2P: + OPAL_PCI_SET_P2P ================ -:: + +.. code-block:: c #define OPAL_PCI_SET_P2P 157 int64_t opal_pci_set_p2p(uint64_t phbid_init, uint64_t phbid_target, - uint64_t desc, uint16_t pe_number) + uint64_t desc, uint16_t pe_number); /* PCI p2p descriptor */ #define OPAL_PCI_P2P_ENABLE 0x1 @@ -16,13 +19,6 @@ The host calls this function to enable PCI peer-to-peer on the PHBs. Parameters ---------- -:: - - uint64_t phbid_init - uint64_t phbid_target - uint64_t desc - uint16_t pe_number - ``phbid_init`` is the value from the PHB node ibm,opal-phbid property for the device initiating the p2p operation @@ -40,11 +36,9 @@ Parameters Return Values ------------- -``OPAL_SUCCESS`` +:ref:`OPAL_SUCCESS` Configuration was successful - -``OPAL_PARAMETER`` +:ref:`OPAL_PARAMETER` Invalid PHB or mode parameter - -``OPAL_UNSUPPORTED`` +:ref:`OPAL_UNSUPPORTED` Not supported by hardware From patchwork Fri May 31 06:12:17 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108056 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ2h4kkmz9sB8 for ; Fri, 31 May 2019 16:16:12 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ2h3rJQzDqYP for ; Fri, 31 May 2019 16:16:12 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0H2y87zDqXs for ; Fri, 31 May 2019 16:14:06 +1000 (AEST) Received: from pps.filterd (m0098414.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V642JC133887 for ; Fri, 31 May 2019 02:14:04 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stwdwjr0e-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:04 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dnPC006009 for ; Fri, 31 May 2019 02:48:55 GMT Received: from b03cxnp08026.gho.boulder.ibm.com (b03cxnp08026.gho.boulder.ibm.com [9.17.130.18]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9ayk9-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:55 +0000 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp08026.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E14w7537112 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id DA6F8C6062 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id A3052C6055 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 9E6514DFDC5; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:17 +1000 Message-Id: <20190531061351.22973-17-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=997 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 016/110] doc: prettify OPAL_[GET|SET]_PBCQ_TUNNEL_BAR X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- ...al-pci-get-set-pbcq-tunnel-bar-164-165.rst | 42 ++++++++----------- 1 file changed, 18 insertions(+), 24 deletions(-) diff --git a/doc/opal-api/opal-pci-get-set-pbcq-tunnel-bar-164-165.rst b/doc/opal-api/opal-pci-get-set-pbcq-tunnel-bar-164-165.rst index 95ee32431ab3..87a2c7decdf1 100644 --- a/doc/opal-api/opal-pci-get-set-pbcq-tunnel-bar-164-165.rst +++ b/doc/opal-api/opal-pci-get-set-pbcq-tunnel-bar-164-165.rst @@ -1,20 +1,19 @@ +.. _OPAL_PCI_GET_PBCQ_TUNNEL_BAR: + OPAL_PCI_GET_PBCQ_TUNNEL_BAR ============================ -:: + +.. code-block:: c #define OPAL_PCI_GET_PBCQ_TUNNEL_BAR 164 - int64_t opal_pci_get_pbcq_tunnel_bar(uint64_t phb_id, uint64_t *addr) + int64_t opal_pci_get_pbcq_tunnel_bar(uint64_t phb_id, uint64_t *addr); The host calls this function to read the address out of the PBCQ Tunnel Bar register. Parameters ---------- -:: - - uint64_t phb_id - uint64_t *addr ``phb_id`` The value from the PHB node ibm,opal-phbid property for the device. @@ -26,36 +25,33 @@ Parameters Return Values ------------- -``OPAL_SUCCESS`` +:ref:`OPAL_SUCCESS` Operation was successful - -``OPAL_PARAMETER`` +:ref:`OPAL_PARAMETER` Invalid PHB or addr parameter - -``OPAL_UNSUPPORTED`` +:ref:`OPAL_UNSUPPORTED` Not supported by hardware +.. _OPAL_PCI_SET_PBCQ_TUNNEL_BAR: + OPAL_PCI_SET_PBCQ_TUNNEL_BAR ============================ -:: + +.. code-block:: c #define OPAL_PCI_SET_PBCQ_TUNNEL_BAR 165 - int64_t opal_pci_set_pbcq_tunnel_bar(uint64_t phb_id, uint64_t addr) + int64_t opal_pci_set_pbcq_tunnel_bar(uint64_t phb_id, uint64_t addr); The host calls this function to set the PBCQ Tunnel Bar register. Parameters ---------- -:: - - uint64_t phb_id - uint64_t addr -``phb_id`` +:ref:``phb_id` The value from the PHB node ibm,opal-phbid property for the device. -``addr`` +:ref:`addr` The value of the address chosen for the PBCQ Tunnel Bar register. If the address is 0, then the PBCQ Tunnel Bar register will be reset. It the address is non-zero, then the PBCQ Tunnel Bar register will be @@ -66,11 +62,9 @@ Parameters Return Values ------------- -``OPAL_SUCCESS`` +:ref:`OPAL_SUCCESS` Operation was successful - -``OPAL_PARAMETER`` +:ref:`OPAL_PARAMETER` Invalid PHB or addr parameter - -``OPAL_UNSUPPORTED`` +:ref:`OPAL_UNSUPPORTED` Not supported by hardware From patchwork Fri May 31 06:12:18 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108071 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ8J1Jn0z9s00 for ; Fri, 31 May 2019 16:21:04 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ8J0Q2pzDqbg for ; Fri, 31 May 2019 16:21:04 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0J5zMgzDqXs for ; Fri, 31 May 2019 16:14:08 +1000 (AEST) Received: from pps.filterd (m0098393.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64CB6076028 for ; Fri, 31 May 2019 02:14:05 -0400 Received: from e32.co.us.ibm.com (e32.co.us.ibm.com [32.97.110.150]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvha4a3k-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:05 -0400 Received: from localhost by e32.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:04 +0100 Received: from b03cxnp08026.gho.boulder.ibm.com (9.17.130.18) by e32.co.us.ibm.com (192.168.1.132) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:02 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp08026.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E2qi26870242 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id E4BB9C6066 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id AB7E0C605A for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id A38974D922E; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:18 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0004-0000-0000-0000151674F5 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:03 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0005-0000-0000-00008BDE979B Message-Id: <20190531061351.22973-18-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=979 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 017/110] doc: prettify and RSTify OPAL_NMMU_SET_PTCR X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- ...tcr-127.txt => opal-nmmu-set-ptcr-127.rst} | 25 ++++++++++++------- 1 file changed, 16 insertions(+), 9 deletions(-) rename doc/opal-api/{opal-nmmu-set-ptcr-127.txt => opal-nmmu-set-ptcr-127.rst} (53%) diff --git a/doc/opal-api/opal-nmmu-set-ptcr-127.txt b/doc/opal-api/opal-nmmu-set-ptcr-127.rst similarity index 53% rename from doc/opal-api/opal-nmmu-set-ptcr-127.txt rename to doc/opal-api/opal-nmmu-set-ptcr-127.rst index eac13f32c09c..0e5181cf4ff1 100644 --- a/doc/opal-api/opal-nmmu-set-ptcr-127.txt +++ b/doc/opal-api/opal-nmmu-set-ptcr-127.rst @@ -1,22 +1,29 @@ +.. _OPAL_NMMU_SET_PTCR: + OPAL_NMMU_SET_PTCR -------------------- +------------------ + +.. code-block:: c -#define OPAL_NMMU_SET_PTCR 127 + #define OPAL_NMMU_SET_PTCR 127 -int64 opal_nmmu_set_ptcr(uint64 chip_id, uint64_t ptcr) + int64 opal_nmmu_set_ptcr(uint64 chip_id, uint64_t ptcr); -Arguments: - uint64 chip_id +``uint64 chip_id`` either the chip id containing the nest mmu who's ptcr should be set or alternatively -1ULL to indicate all nest mmu ptcr's should be set to the same value. - uint64 ptcr +``uint64 ptcr`` ptcr value pointing to either the radix tables or hash tables. This OPAL call sets up the Nest MMU by pointing it at the radix page table base or the hash page table base (HTABORG). -Return Values: -OPAL_SUCCESS: the power down was updated successful -OPAL_PARAMETER: a parameter was incorrect +Return Values +^^^^^^^^^^^^^ + +:ref:`OPAL_SUCCESS` + the PTCR was updated successful +:ref:`OPAL_PARAMETER` + a parameter was incorrect From patchwork Fri May 31 06:12:19 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108066 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ6x6yrZz9s00 for ; Fri, 31 May 2019 16:19:53 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ6x62DMzDqZX for ; Fri, 31 May 2019 16:19:53 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0J4cBxzDqYV for ; Fri, 31 May 2019 16:14:08 +1000 (AEST) Received: from pps.filterd (m0098409.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V644Rk060123 for ; Fri, 31 May 2019 02:14:06 -0400 Received: from e33.co.us.ibm.com (e33.co.us.ibm.com [32.97.110.151]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4v99wv-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:06 -0400 Received: from localhost by e33.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:05 +0100 Received: from b03cxnp08027.gho.boulder.ibm.com (9.17.130.19) by e33.co.us.ibm.com (192.168.1.133) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:02 +0100 Received: from b03ledav001.gho.boulder.ibm.com (b03ledav001.gho.boulder.ibm.com [9.17.130.232]) by b03cxnp08027.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E2RB25035208 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id E88726E052 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B20A46E056 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav001.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id A7C2A4D8D8A; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:19 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0036-0000-0000-00000AC51850 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:03 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0037-0000-0000-00004C021473 Message-Id: <20190531061351.22973-19-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=941 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 018/110] doc: prettify OPAL_PCI_TCE_KILL X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-tce-kill-126.rst | 27 +++++++++++++++++--------- 1 file changed, 18 insertions(+), 9 deletions(-) diff --git a/doc/opal-api/opal-pci-tce-kill-126.rst b/doc/opal-api/opal-pci-tce-kill-126.rst index dc7ab6b12eb5..edd8706b9c9e 100644 --- a/doc/opal-api/opal-pci-tce-kill-126.rst +++ b/doc/opal-api/opal-pci-tce-kill-126.rst @@ -1,18 +1,23 @@ +.. _OPAL_PCI_TCE_KILL: + OPAL_PCI_TCE_KILL ================= -:: + +.. code-block:: c int64_t opal_pci_tce_kill(uint64_t phb_id, uint32_t kill_type, uint64_t pe_number, uint32_t tce_size, uint64_t dma_addr, - uint32_t npages) + uint32_t npages); An abstraction around TCE kill. This allows host OS kernels to use an OPAL call if they don't know the model specific invalidation method. -Where kill_type is one of: :: +Where kill_type is one of: + +.. code-block:: c enum { OPAL_PCI_TCE_KILL_PAGES, @@ -25,16 +30,17 @@ PHB4, which means from POWER9 onwards it will be present. Returns ------- -OPAL_PARAMETER - if phb_id is invalid (or similar) - -OPAL_UNSUPPORTED +:ref:`OPAL_PARAMETER` + if ``phb_id`` is invalid (or similar) +:ref:`OPAL_UNSUPPORTED` if PHB model doesn't support this call. This is likely true for systems before POWER9/PHB4. Do *NOT* rely on this call existing for systems prior to POWER9 (i.e. PHB4). -Example code (from linux/arch/powerpc/platforms/powernv/pci-ioda.c) :: +Example code (from linux/arch/powerpc/platforms/powernv/pci-ioda.c) + +.. code-block:: c static inline void pnv_pci_ioda2_tce_invalidate_pe(struct pnv_ioda_pe *pe) { @@ -47,10 +53,13 @@ Example code (from linux/arch/powerpc/platforms/powernv/pci-ioda.c) :: pe->pe_number, 0, 0, 0); } -and :: +and + +.. code-block:: c struct pnv_phb *phb = pe->phb; unsigned int shift = tbl->it_page_shift; + if (phb->model == PNV_PHB_MODEL_PHB3 && phb->regs) pnv_pci_phb3_tce_invalidate(pe, rm, shift, index, npages); From patchwork Fri May 31 06:12:20 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108078 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ9r0Ywjz9sDX for ; Fri, 31 May 2019 16:22:24 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ9q57LHzDqWb for ; Fri, 31 May 2019 16:22:23 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0K1lJNzDqYY for ; Fri, 31 May 2019 16:14:08 +1000 (AEST) Received: from pps.filterd (m0098421.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V6761Z066819 for ; Fri, 31 May 2019 02:14:06 -0400 Received: from e36.co.us.ibm.com (e36.co.us.ibm.com [32.97.110.154]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stxqh875x-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:05 -0400 Received: from localhost by e36.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:05 +0100 Received: from b03cxnp08026.gho.boulder.ibm.com (9.17.130.18) by e36.co.us.ibm.com (192.168.1.136) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:03 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp08026.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E2t012386596 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 3B47F6A054 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id CB5146A04F for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id AD724503F60; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:20 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0020-0000-0000-00000EF27379 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:04 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0021-0000-0000-000066081ED0 Message-Id: <20190531061351.22973-20-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=919 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 019/110] doc: prettify OPAL_INT_* calls X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-int-eoi-124.rst | 13 ++++++++----- doc/opal-api/opal-int-get-xirr-122.rst | 13 ++++++++----- doc/opal-api/opal-int-set-cppr-123.rst | 12 +++++++----- doc/opal-api/opal-int-set-mfrr-125.rst | 14 +++++++++----- doc/xive.rst | 1 + 5 files changed, 33 insertions(+), 20 deletions(-) diff --git a/doc/opal-api/opal-int-eoi-124.rst b/doc/opal-api/opal-int-eoi-124.rst index ec5bdd264399..c7d991c884ba 100644 --- a/doc/opal-api/opal-int-eoi-124.rst +++ b/doc/opal-api/opal-int-eoi-124.rst @@ -1,10 +1,13 @@ +.. _OPAL_INT_EOI: + OPAL_INT_EOI ============ -:: - static int64_t opal_xive_eoi(uint32_t xirr) +.. code-block:: c + + #define OPAL_INT_EOI 124 -**Not yet implemented.** + static int64_t opal_int_eoi(uint32_t xirr); Modelled on the ``H_EOI`` PAPR call. @@ -17,5 +20,5 @@ For P9 and above systems where host doesn't know about interrupt controller. An OS can instead make OPAL calls for XICS emulation. For an OS to use this OPAL call, an ``ibm,opal-intc`` compatible device must -exist in the device tree. If OPAL does not create such a device, the host -OS MUST NOT use this call. +exist in the device tree (see :ref:`xive-device-tree`). If OPAL does not create +such a device, the host OS MUST NOT use this call. diff --git a/doc/opal-api/opal-int-get-xirr-122.rst b/doc/opal-api/opal-int-get-xirr-122.rst index b79be6f7a420..85daa15f441d 100644 --- a/doc/opal-api/opal-int-get-xirr-122.rst +++ b/doc/opal-api/opal-int-get-xirr-122.rst @@ -1,10 +1,13 @@ +.. _OPAL_INT_GET_XIRR: + OPAL_INT_GET_XIRR ================= -:: - int64_t opal_xive_get_xirr(uint32_t *out_xirr, bool just_poll) +.. code-block:: c + + #define OPAL_INT_GET_XIRR 122 -**Not yet implemented.** + int64_t opal_int_get_xirr(uint32_t *out_xirr, bool just_poll); Modelled on the PAPR call. @@ -12,5 +15,5 @@ For P9 and above systems where host doesn't know about interrupt controller. An OS can instead make OPAL calls for XICS emulation. For an OS to use this OPAL call, an ``ibm,opal-intc`` compatible device must -exist in the device tree. If OPAL does not create such a device, the host -OS MUST NOT use this call. +exist in the device tree (see :ref:`xive-device-tree`). If OPAL does not create +such a device, the host OS MUST NOT use this call. diff --git a/doc/opal-api/opal-int-set-cppr-123.rst b/doc/opal-api/opal-int-set-cppr-123.rst index ad1e5a4b69f1..918022a82602 100644 --- a/doc/opal-api/opal-int-set-cppr-123.rst +++ b/doc/opal-api/opal-int-set-cppr-123.rst @@ -1,11 +1,13 @@ +.. _OPAL_INT_SET_CPPR: + OPAL_INT_SET_CPPR ================= -:: - static int64_t opal_xive_set_cppr(uint8_t cppr) +.. code-block:: c + #define OPAL_INT_SET_CPPR 123 -**Not yet implemented.** + static int64_t opal_int_set_cppr(uint8_t cppr); Modelled on the ``H_CPPR`` PAPR call. @@ -13,5 +15,5 @@ For P9 and above systems where host doesn't know about interrupt controller. An OS can instead make OPAL calls for XICS emulation. For an OS to use this OPAL call, an ``ibm,opal-intc`` compatible device must -exist in the device tree. If OPAL does not create such a device, the host -OS MUST NOT use this call. +exist in the device tree (see :ref:`xive-device-tree`). If OPAL does not create +such a device, the host OS MUST NOT use this call. diff --git a/doc/opal-api/opal-int-set-mfrr-125.rst b/doc/opal-api/opal-int-set-mfrr-125.rst index 46b090299024..8e0f1853024a 100644 --- a/doc/opal-api/opal-int-set-mfrr-125.rst +++ b/doc/opal-api/opal-int-set-mfrr-125.rst @@ -1,10 +1,14 @@ +.. _OPAL_INT_SET_MFRR: + OPAL_INT_SET_MFRR ================= -:: - static int64_t opal_xive_set_mfrr(uint32_t cpu, uint8_t mfrr) +.. code-block:: c + + #define OPAL_INT_SET_MFRR 125 + + static int64_t opal_int_set_mfrr(uint32_t cpu, uint8_t mfrr); -**Not yet implemented.** Modelled on the ``H_IPI`` PAPR call. @@ -12,5 +16,5 @@ For P9 and above systems where host doesn't know about interrupt controller. An OS can instead make OPAL calls for XICS emulation. For an OS to use this OPAL call, an ``ibm,opal-intc`` compatible device must -exist in the device tree. If OPAL does not create such a device, the host -OS MUST NOT use this call. +exist in the device tree (see :ref:`xive-device-tree`). If OPAL does not create +such a device, the host OS MUST NOT use this call. diff --git a/doc/xive.rst b/doc/xive.rst index 42a60907f393..fe7c737df63c 100644 --- a/doc/xive.rst +++ b/doc/xive.rst @@ -1,6 +1,7 @@ P9 XIVE Exploitation ==================== +.. _xive-device-tree: I - Device-tree updates ----------------------- From patchwork Fri May 31 06:12:21 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108094 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZFk6l5Kz9s00 for ; Fri, 31 May 2019 16:25:46 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZFk5vNfzDqZ2 for ; Fri, 31 May 2019 16:25:46 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0L4V7wzDqY6 for ; Fri, 31 May 2019 16:14:10 +1000 (AEST) Received: from pps.filterd (m0098420.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V6B3Tn086894 for ; Fri, 31 May 2019 02:14:06 -0400 Received: from e17.ny.us.ibm.com (e17.ny.us.ibm.com [129.33.205.207]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxsbg1t9-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:06 -0400 Received: from localhost by e17.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:05 +0100 Received: from b01cxnp22034.gho.pok.ibm.com (9.57.198.24) by e17.ny.us.ibm.com (146.89.104.204) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:03 +0100 Received: from b01ledav001.gho.pok.ibm.com (b01ledav001.gho.pok.ibm.com [9.57.199.106]) by b01cxnp22034.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E2gS36831314 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 2F94D28060 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id E0F8C28058 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav001.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id B1BB4503F61; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:21 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0040-0000-0000-000004F6E3CF X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:04 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0041-0000-0000-00000902FE9E Message-Id: <20190531061351.22973-21-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 020/110] doc: prettify OPAL_PCI_[GET|SET]_POWER_STATE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-get-power-state-120.rst | 17 ++++++++++---- doc/opal-api/opal-pci-set-power-state-121.rst | 23 +++++++++++-------- 2 files changed, 26 insertions(+), 14 deletions(-) diff --git a/doc/opal-api/opal-pci-get-power-state-120.rst b/doc/opal-api/opal-pci-get-power-state-120.rst index 9e6f94b7084d..fa0375d83e85 100644 --- a/doc/opal-api/opal-pci-get-power-state-120.rst +++ b/doc/opal-api/opal-pci-get-power-state-120.rst @@ -1,6 +1,14 @@ +.. _OPAL_PCI_GET_POWER_STATE: + OPAL_PCI_GET_POWER_STATE ======================== +.. code-block:: c + + #define OPAL_PCI_GET_POWER_STATE 120 + + int64_t opal_pci_get_power_state(uint64_t id, uint64_t data); + Get PCI slot power state Parameter @@ -20,11 +28,10 @@ in buffer pointed by @data. Return Codes ------------ -OPAL_SUCCESS - PCI slot's power state is retrieved successfully -OPAL_PARAMETER +:ref:`OPAL_SUCCESS` + PCI slot's power state is retrieved successfully +:ref:`OPAL_PARAMETER` The indicated PCI slot isn't found - -OPAL_UNSUPPORTED +:ref:`OPAL_UNSUPPORTED` Power state retrieval not supported on the PCI slot diff --git a/doc/opal-api/opal-pci-set-power-state-121.rst b/doc/opal-api/opal-pci-set-power-state-121.rst index 54c1a33ac2ff..0209efb79316 100644 --- a/doc/opal-api/opal-pci-set-power-state-121.rst +++ b/doc/opal-api/opal-pci-set-power-state-121.rst @@ -1,6 +1,14 @@ +.. _OPAL_PCI_SET_POWER_STATE: + OPAL_PCI_SET_POWER_STATE ======================== +.. code-block:: c + + #define OPAL_PCI_SET_POWER_STATE 121 + + int64_t opal_pci_set_power_state(uint64_t async_token, uint64_t id, uint64_t data); + Set PCI slot power state Parameters @@ -27,8 +35,8 @@ indicated PCI slot (by @id) in PCI hotplug path. User will receive an asychronous message after calling the API. The message contains the API completion status: event (Power off or on), device node's -phandle identifying the PCI slot, errcode (e.g. OPAL_SUCCESS). The API returns -OPAL_ASYNC_COMPLETION for the case. +phandle identifying the PCI slot, errcode (e.g. :ref:`OPAL_SUCCESS`). The API returns +:ref:`OPAL_ASYNC_COMPLETION` for the case. The states OPAL_PCI_SLOT_OFFLINE and OPAL_PCI_SLOT_ONLINE are used for removing or adding devices behind the slot. The device nodes in the device tree are @@ -39,14 +47,11 @@ message will be sent. Return Codes ------------ -OPAL_SUCCESS +:ref:`OPAL_SUCCESS` PCI hotplug on the slot is completed successfully - -OPAL_ASYNC_COMPLETION +:ref:`OPAL_ASYNC_COMPLETION` PCI hotplug needs further message to confirm - -OPAL_PARAMETER +:ref:`OPAL_PARAMETER` The indicated PCI slot isn't found - -OPAL_UNSUPPORTED +:ref:`OPAL_UNSUPPORTED` Setting power state not supported on the PCI slot From patchwork Fri May 31 06:12:22 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108077 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ9c2bLPz9s00 for ; Fri, 31 May 2019 16:22:12 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ9c1Cm5zDqZn for ; Fri, 31 May 2019 16:22:12 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0K2tSXzDqYC for ; Fri, 31 May 2019 16:14:09 +1000 (AEST) Received: from pps.filterd (m0098396.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V641PC037612 for ; Fri, 31 May 2019 02:14:04 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4v1d3g-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:04 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dbKh005901 for ; Fri, 31 May 2019 02:48:55 GMT Received: from b01cxnp23034.gho.pok.ibm.com (b01cxnp23034.gho.pok.ibm.com [9.57.198.29]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9ayka-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:55 +0000 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp23034.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E2g637224808 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 340F8B2067 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id E4F42B205F for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id B6298503F62; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:22 +1000 Message-Id: <20190531061351.22973-22-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 021/110] doc: prettify OPAL_GET_DEVICE_TREE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-get-device-tree-118.rst | 37 +++++++++++++---------- 1 file changed, 21 insertions(+), 16 deletions(-) diff --git a/doc/opal-api/opal-get-device-tree-118.rst b/doc/opal-api/opal-get-device-tree-118.rst index af3fdf7044e1..df00205af310 100644 --- a/doc/opal-api/opal-get-device-tree-118.rst +++ b/doc/opal-api/opal-get-device-tree-118.rst @@ -1,36 +1,41 @@ +.. _OPAL_GET_DEVICE_TREE: + OPAL_GET_DEVICE_TREE ==================== -Get device sub-tree. +.. code-block:: c + + #define OPAL_GET_DEVICE_TREE 118 -Parameters: :: + int64_t opal_get_device_tree(uint32_t phandle, uint64_t buf, uint64_t len); + +Get device sub-tree. - uint32_t phandle: root device node phandle of the device sub-tree - uint64_t buf: FDT blob buffer or NULL - uint64_t len: length of the FDT blob buffer +``uint32_t phandle`` + root device node phandle of the device sub-tree +``uint64_t buf`` + FDT blob buffer or NULL +``uint64_t len`` + length of the FDT blob buffer -Calling: Retrieve device sub-tree. The root node's phandle is identified by @phandle. The typical use is for the kernel to update its device tree following a change in hardware (e.g. PCI hotplug). -Return Codes: +Return Codes +^^^^^^^^^^^^ FDT blob size returned FDT blob buffer size when ``buf`` is NULL -OPAL_SUCCESS +:ref:`OPAL_SUCCESS` FDT blob is created successfully - -OPAL_PARAMETER +:ref:`OPAL_PARAMETER` invalid argument @phandle or @len - -OPAL_INTERNAL_ERROR +:ref:`OPAL_INTERNAL_ERROR` failure creating FDT blob when calculating its size - -OPAL_NO_MEM +:ref:`OPAL_NO_MEM` not enough room in buffer for device sub-tree - -OPAL_EMPTY +:ref:`OPAL_EMPTY` failure creating FDT blob From patchwork Fri May 31 06:12:23 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108069 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ7s2Xh2z9s00 for ; Fri, 31 May 2019 16:20:41 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ7s1dwBzDqXv for ; Fri, 31 May 2019 16:20:41 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0J3mdtzDqYP for ; Fri, 31 May 2019 16:14:08 +1000 (AEST) Received: from pps.filterd (m0098393.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64BIE075974 for ; Fri, 31 May 2019 02:14:06 -0400 Received: from e35.co.us.ibm.com (e35.co.us.ibm.com [32.97.110.153]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvha4a3u-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:05 -0400 Received: from localhost by e35.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:05 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e35.co.us.ibm.com (192.168.1.135) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:03 +0100 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E2Bg16122188 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 1CA9EBE056 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id D98AABE054 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id BB0E4503F63; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:23 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0012-0000-0000-0000173DDCF8 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:04 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0013-0000-0000-00005778F802 Message-Id: <20190531061351.22973-23-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=933 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 022/110] doc: prettify OPAL_PCI_GET_PRESENCE_STATE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-get-presence-state-119.rst | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/doc/opal-api/opal-pci-get-presence-state-119.rst b/doc/opal-api/opal-pci-get-presence-state-119.rst index 23ea831910e3..b31df47a8b36 100644 --- a/doc/opal-api/opal-pci-get-presence-state-119.rst +++ b/doc/opal-api/opal-pci-get-presence-state-119.rst @@ -1,6 +1,14 @@ +.. _OPAL_PCI_GET_PRESENCE_STATE: + OPAL_PCI_GET_PRESENCE_STATE =========================== +.. code-block: c + + #define OPAL_PCI_GET_PRESENCE_STATE 119 + + int64_t opal_pci_get_presence_state(uint64_t id, uint64_t data); + Get PCI slot presence state Parameters @@ -23,11 +31,9 @@ state is stored in buffer pointed by @data. Return Codes ------------ -OPAL_SUCCESS +:ref:`OPAL_SUCCESS` PCI slot's presence state is retrieved successfully - -OPAL_PARAMETER +:ref:`OPAL_PARAMETER` The indicated PCI slot isn't found - -OPAL_UNSUPPORTED +:ref:`OPAL_UNSUPPORTED` Presence retrieval not supported on the PCI slot From patchwork Fri May 31 06:12:24 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108086 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZCk4BFlz9s00 for ; Fri, 31 May 2019 16:24:02 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZCk3BTjzDqWm for ; Fri, 31 May 2019 16:24:02 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0K6ZrJzDqYh for ; Fri, 31 May 2019 16:14:09 +1000 (AEST) Received: from pps.filterd (m0098394.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V66ULL092904 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e13.ny.us.ibm.com (e13.ny.us.ibm.com [129.33.205.203]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stv42d06p-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:06 -0400 Received: from localhost by e13.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:05 +0100 Received: from b01cxnp22035.gho.pok.ibm.com (9.57.198.25) by e13.ny.us.ibm.com (146.89.104.200) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:03 +0100 Received: from b01ledav002.gho.pok.ibm.com (b01ledav002.gho.pok.ibm.com [9.57.199.107]) by b01cxnp22035.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E2bT30670952 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 3CF59124054 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id EEBC3124055 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav002.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id C221D503F64; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:24 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0064-0000-0000-000003E76F3A X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:03 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0065-0000-0000-00003DAD78DF Message-Id: <20190531061351.22973-24-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 023/110] doc: prettify OPAL_PRD_MSG X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-messages.rst | 4 +++- doc/opal-api/opal-prd-msg-113.rst | 10 +++++++++- 2 files changed, 12 insertions(+), 2 deletions(-) diff --git a/doc/opal-api/opal-messages.rst b/doc/opal-api/opal-messages.rst index b023622d2d26..e7de77d96850 100644 --- a/doc/opal-api/opal-messages.rst +++ b/doc/opal-api/opal-messages.rst @@ -134,6 +134,8 @@ requested and a forced shutdown will happen in future. Host OS can use OPAL_GET_DPO_STATUS API to query OPAL the number of seconds remaining before a forced poweroff will occur. +.. _OPAL_MSG_PRD: + OPAL_MSG_PRD ------------ @@ -177,7 +179,7 @@ struct opal_prd_msg: :: }; Responses from the kernel use the same message format, but are passed -through the opal_prd_msg call. +through the :ref:`OPAL_PRD_MSG` call. OPAL_MSG_OCC ------------ diff --git a/doc/opal-api/opal-prd-msg-113.rst b/doc/opal-api/opal-prd-msg-113.rst index 0cda30aa5285..91d30aca7552 100644 --- a/doc/opal-api/opal-prd-msg-113.rst +++ b/doc/opal-api/opal-prd-msg-113.rst @@ -1,8 +1,16 @@ +.. _OPAL_PRD_MSG: + OPAL_PRD_MSG ============ +.. code-block:: c + + #define OPAL_PRD_MSG 113 + + int64_t opal_prd_msg(struct opal_prd_msg *msg); + The OPAL_PRD_MSG call is used to pass a struct opal_prd_msg from the HBRT -code into opal, and is paired with the OPAL_PRD_MSG message type. +code into opal, and is paired with the :ref:`OPAL_PRD_MSG` message type. Parameters ---------- From patchwork Fri May 31 06:12:25 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108080 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZBK3NQhz9s00 for ; Fri, 31 May 2019 16:22:49 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZBK2DZvzDqYM for ; Fri, 31 May 2019 16:22:49 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0K4HJXzDqXX for ; Fri, 31 May 2019 16:14:09 +1000 (AEST) Received: from pps.filterd (m0098399.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64CkN137036 for ; Fri, 31 May 2019 02:14:05 -0400 Received: from e33.co.us.ibm.com (e33.co.us.ibm.com [32.97.110.151]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvyfukjv-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:04 -0400 Received: from localhost by e33.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:04 +0100 Received: from b03cxnp08026.gho.boulder.ibm.com (9.17.130.18) by e33.co.us.ibm.com (192.168.1.133) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:03 +0100 Received: from b03ledav002.gho.boulder.ibm.com (b03ledav002.gho.boulder.ibm.com [9.17.130.233]) by b03cxnp08026.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E2vu26542486 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b03ledav002.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 22789136055 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b03ledav002.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id DF7E5136053 for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav002.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:01 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id C6CE4503F65; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:25 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0036-0000-0000-00000AC5184F X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:03 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0037-0000-0000-00004C021476 Message-Id: <20190531061351.22973-25-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 024/110] doc: prettify OPAL_IPMI_(SEND|RECV) X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-ipmi-send-recv-107-108.rst | 111 +++++++++---------- 1 file changed, 53 insertions(+), 58 deletions(-) diff --git a/doc/opal-api/opal-ipmi-send-recv-107-108.rst b/doc/opal-api/opal-ipmi-send-recv-107-108.rst index 581f10622a05..b8c3ed1f6c73 100644 --- a/doc/opal-api/opal-ipmi-send-recv-107-108.rst +++ b/doc/opal-api/opal-ipmi-send-recv-107-108.rst @@ -1,102 +1,97 @@ +.. _OPAL_IPMI_SEND: + OPAL_IPMI_SEND ============== -:: + +.. code-block:: c #define OPAL_IPMI_SEND 107 -``OPAL_IPMI_SEND`` call will send an IPMI message to the service processor. + enum { + OPAL_IPMI_MSG_FORMAT_VERSION_1 = 1, + }; + + struct opal_ipmi_msg { + uint8_t version; + uint8_t netfn; + uint8_t cmd; + uint8_t data[]; + }; + + int64_t opal_ipmi_send(uint64_t interface, + struct opal_ipmi_msg *opal_ipmi_msg, uint64_t msg_len); + +:ref:`OPAL_IPMI_SEND` call will send an IPMI message to the service processor. Parameters ---------- -:: - - uint64_t interface - struct opal_ipmi_msg *opal_ipmi_msg - uint64_t msg_len ``interface`` - ``interface`` parameter is the value from the ipmi interface node ``ibm,ipmi-interface-id`` - + ``interface`` parameter is the value from the ipmi interface node ``ibm,ipmi-interface-id`` ``opal_ipmi_msg`` - ``opal_ipmi_msg`` is the pointer to below structure ``opal_ipmi_msg`` - -:: - - struct opal_ipmi_msg { - uint8_t version; - uint8_t netfn; - uint8_t cmd; - uint8_t data[]; - }; - + ``opal_ipmi_msg`` is the pointer to a ``struct opal_ipmi_msg`` (see above) ``msg_len`` - ipmi message request size + ipmi message request size Return Values ------------- -``OPAL_SUCCESS`` +:ref:`OPAL_SUCCESS` ``msg`` queued successfully - -``OPAL_PARAMETER`` +:ref:`OPAL_PARAMETER` invalid ipmi message request length ``msg_len`` - -``OPAL_HARDWARE`` +:ref:`OPAL_HARDWARE` backend support is not present as block transfer/service processor ipmi routines are not initialized which are used for communication - -``OPAL_UNSUPPORTED`` +:ref:`OPAL_UNSUPPORTED` in-correct opal ipmi message format version ``opal_ipmi_msg->version`` - -``OPAL_RESOURCE`` +:ref:`OPAL_RESOURCE` insufficient resources to create ``ipmi_msg`` structure +.. _OPAL_IPMI_RECV: + OPAL_IPMI_RECV ============== -:: + +.. code-block:: c #define OPAL_IPMI_RECV 108 + enum { + OPAL_IPMI_MSG_FORMAT_VERSION_1 = 1, + }; + + struct opal_ipmi_msg { + uint8_t version; + uint8_t netfn; + uint8_t cmd; + uint8_t data[]; + }; + + int64_t opal_ipmi_recv(uint64_t interface, + struct opal_ipmi_msg *opal_ipmi_msg, uint64_t *msg_len) + ``OPAL_IPMI_RECV`` call reads an ipmi message of type ``ipmi_msg`` from ipmi message queue ``msgq`` into host OS structure ``opal_ipmi_msg``. Parameters ---------- -:: - - uint64_t interface - struct opal_ipmi_msg *opal_ipmi_msg - uint64_t *msg_len ``interface`` - ``interface`` parameter is the value from the ipmi interface node ``ibm,ipmi-interface-id`` - + ``interface`` parameter is the value from the ipmi interface node ``ibm,ipmi-interface-id`` ``opal_ipmi_msg`` - ``opal_ipmi_msg`` is the pointer to below structure ``opal_ipmi_msg`` - -:: - - struct opal_ipmi_msg { - uint8_t version; - uint8_t netfn; - uint8_t cmd; - uint8_t data[]; - }; - + ``opal_ipmi_msg`` is the pointer to a ``struct opal_ipmi_msg`` (see above) ``msg_len`` - ``msg_len`` is the pointer to ipmi message response size + ``msg_len`` is the pointer to ipmi message response size Return Values ------------- -``OPAL_SUCCESS`` +:ref:`OPAL_SUCCESS` ipmi message dequeued from ``msgq`` queue and memory taken by it got released successfully - -``OPAL_EMPTY`` +:ref:`OPAL_EMPTY` ``msgq`` list is empty - -``OPAL_PARAMETER`` +ref:`OPAL_PARAMETER` invalid ipmi ``interface`` value - -``OPAL_UNSUPPORTED`` - in-correct opal ipmi message format version ``opal_ipmi_msg->version`` +:ref:`OPAL_UNSUPPORTED` + incorrect opal ipmi message format version ``opal_ipmi_msg->version`` From patchwork Fri May 31 06:12:26 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108092 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZFC4tqFz9s00 for ; Fri, 31 May 2019 16:25:19 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZFC1xMhzDqXD for ; Fri, 31 May 2019 16:25:19 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0L4RT0zDqY0 for ; Fri, 31 May 2019 16:14:10 +1000 (AEST) Received: from pps.filterd (m0098421.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V674wV066702 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e32.co.us.ibm.com (e32.co.us.ibm.com [32.97.110.150]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stxqh876k-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e32.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:06 +0100 Received: from b03cxnp08027.gho.boulder.ibm.com (9.17.130.19) by e32.co.us.ibm.com (192.168.1.132) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:03 +0100 Received: from b03ledav001.gho.boulder.ibm.com (b03ledav001.gho.boulder.ibm.com [9.17.130.232]) by b03cxnp08027.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E2YO29294880 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 9DF366E04C for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 6736F6E04E for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav001.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id CB1FE503F66; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:26 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0004-0000-0000-0000151674F7 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:04 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0005-0000-0000-00008BDE979D Message-Id: <20190531061351.22973-26-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 025/110] doc: prettify OPAL_SLW_SET_REG X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-slw-set-reg-100.rst | 40 +++++++++++++-------------- 1 file changed, 19 insertions(+), 21 deletions(-) diff --git a/doc/opal-api/opal-slw-set-reg-100.rst b/doc/opal-api/opal-slw-set-reg-100.rst index 64ecdee4544e..2e8f1bd61ff2 100644 --- a/doc/opal-api/opal-slw-set-reg-100.rst +++ b/doc/opal-api/opal-slw-set-reg-100.rst @@ -1,20 +1,22 @@ +.. _OPAL_SLW_SET_REG: + OPAL_SLW_SET_REG -============================== -:: +================ - int64_t opal_slw_set_reg(uint64_t cpu_pir, uint64_t sprn, uint64_t val) +.. code-block:: c + #define OPAL_SLW_SET_REG 100 -OPAL_SLW_SET_REG is used to inform low-level firmware to restore a -given value of SPR when there is a state loss. The actual set of SPR -that is supported is platform dependent. + int64_t opal_slw_set_reg(uint64_t cpu_pir, uint64_t sprn, uint64_t val); +:ref:`OPAL_SLW_SET_REG` is used to inform low-level firmware to restore a +given value of SPR when there is a state loss. The actual set of SPRs +that are supported is platform dependent. In Power 8, it uses p8_pore_gen_cpufreq_fixed(), api provided by pore engine, to inform the spr with their corresponding values with which they must be restored. - In Power 9, it uses p9_stop_save_cpureg(), api provided by self restore code, to inform the spr with their corresponding values with which they must be restored. @@ -24,23 +26,19 @@ Parameters ---------- ``uint64_t cpu_pir`` -This parameter specifies the pir of the cpu for which the call is being made. - + This parameter specifies the pir of the cpu for which the call is being made. ``uint64_t sprn`` -This parameter specifies the spr number as mentioned in p9_stop_api.H for -Power9 and p8_pore_table_gen_api.H for Power8. - + This parameter specifies the spr number as mentioned in p9_stop_api.H for + Power9 and p8_pore_table_gen_api.H for Power8. ``uint64_t val`` -This parameter specifices value with which the spr should be restored. + This parameter specifices value with which the spr should be restored. Returns ------- -``OPAL_INTERNAL_ERROR`` -On failure. The actual error code from the platform specific code is logged in the OPAL logs - -``OPAL_UNSUPPORTED`` -In power8 only, if spr restore is not supported by pore engine. - -``OPAL_SUCCESS`` -On success +:ref:`OPAL_INTERNAL_ERROR` + On failure. The actual error code from the platform specific code is logged in the OPAL logs +:ref:`OPAL_UNSUPPORTED` + If spr restore is not supported by pore engine. +:ref:`OPAL_SUCCESS` + On success From patchwork Fri May 31 06:12:27 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108087 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZCy47nFz9s00 for ; Fri, 31 May 2019 16:24:14 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZCy396JzDqcQ for ; Fri, 31 May 2019 16:24:14 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0L0fy7zDqYS for ; Fri, 31 May 2019 16:14:09 +1000 (AEST) Received: from pps.filterd (m0098409.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64ACs060572 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e31.co.us.ibm.com (e31.co.us.ibm.com [32.97.110.149]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4v99xg-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e31.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:06 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e31.co.us.ibm.com (192.168.1.131) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:03 +0100 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E2MI31326574 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 9C8DDBE054 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 6F031BE04F for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id D17A2503F67; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:27 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-8235-0000-0000-00000EA0F3A7 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:04 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-8236-0000-0000-000045C9C0E8 Message-Id: <20190531061351.22973-27-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=838 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 026/110] doc: prettify OPAL_CHECK_TOKEN X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-check-token-80.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/opal-api/opal-check-token-80.rst b/doc/opal-api/opal-check-token-80.rst index fb63179f7bac..34eb0a224c00 100644 --- a/doc/opal-api/opal-check-token-80.rst +++ b/doc/opal-api/opal-check-token-80.rst @@ -1,6 +1,14 @@ +.. _OPAL_CHECK_TOKEN: + OPAL_CHECK_TOKEN ================ +.. code-block:: c + + #define OPAL_CHECK_TOKEN 80 + + int64_t opal_check_token(uint64_t token); + This OPAL call allows the host OS to determine if a particular OPAL call is present on a system. This allows for simple compatibility between OPAL versions and different OPAL implementations/platforms. From patchwork Fri May 31 06:12:28 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108091 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZDx07mwz9s00 for ; Fri, 31 May 2019 16:25:05 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZDw6QBZzDqYC for ; Fri, 31 May 2019 16:25:04 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0L4zHxzDqYn for ; Fri, 31 May 2019 16:14:10 +1000 (AEST) Received: from pps.filterd (m0098419.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V658h5135306 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e16.ny.us.ibm.com (e16.ny.us.ibm.com [129.33.205.206]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stv224n58-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e16.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:06 +0100 Received: from b01cxnp22035.gho.pok.ibm.com (9.57.198.25) by e16.ny.us.ibm.com (146.89.104.203) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:03 +0100 Received: from b01ledav002.gho.pok.ibm.com (b01ledav002.gho.pok.ibm.com [9.57.199.107]) by b01cxnp22035.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E25V30670956 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id DC5AE124055 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 991BA124053 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav002.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id D5D7E503F68; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:28 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0072-0000-0000-00000435AFC2 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:04 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0073-0000-0000-00004C6D3D04 Message-Id: <20190531061351.22973-28-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 027/110] doc: prettify OPAL_PCI_SET_PHB_CAPI_MODE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- .../opal-pci-set-phb-capi-mode-93.rst | 60 ++++++++++++------- 1 file changed, 37 insertions(+), 23 deletions(-) diff --git a/doc/opal-api/opal-pci-set-phb-capi-mode-93.rst b/doc/opal-api/opal-pci-set-phb-capi-mode-93.rst index 6a8d2be849d4..ffc4c6dc9fea 100644 --- a/doc/opal-api/opal-pci-set-phb-capi-mode-93.rst +++ b/doc/opal-api/opal-pci-set-phb-capi-mode-93.rst @@ -1,30 +1,47 @@ +.. _OPAL_PCI_SET_PHB_CAPI_MODE: + OPAL_PCI_SET_PHB_CAPI_MODE -=========================== +========================== + +.. code-block:: c + + #define OPAL_PCI_SET_PHB_CAPI_MODE 93 + + /* CAPI modes for PHB */ + enum { + OPAL_PHB_CAPI_MODE_PCIE = 0, + OPAL_PHB_CAPI_MODE_CAPI = 1, + OPAL_PHB_CAPI_MODE_SNOOP_OFF = 2, + OPAL_PHB_CAPI_MODE_SNOOP_ON = 3, + OPAL_PHB_CAPI_MODE_DMA = 4, + OPAL_PHB_CAPI_MODE_DMA_TVT1 = 5, + }; -Switch the CAPP attached to the given PHB in one of the supported CAPI modes + int64_t opal_pci_set_phb_capi_mode(uint64_t phb_id, uint64_t mode, uint64_t pe_number); + +Switch the CAPP attached to the given PHB in one of the supported CAPI modes. Parameters ---------- + ``uint64_t phb_id`` the ID of the PHB which identifies attached CAPP to perform mode switch on - ``uint64_t mode`` A mode id as described below - ``pe_number`` PE number for the initiating device Calling ------- -Switch CAPP attached to the given PHB in one of the following supported modes: +Switch CAPP attached to the given PHB in one of the following supported modes: :: -OPAL_PHB_CAPI_MODE_PCIE = 0 -OPAL_PHB_CAPI_MODE_CAPI = 1 -OPAL_PHB_CAPI_MODE_SNOOP_OFF = 2 -OPAL_PHB_CAPI_MODE_SNOOP_ON = 3 -OPAL_PHB_CAPI_MODE_DMA = 4 -OPAL_PHB_CAPI_MODE_DMA_TVT1 = 5 + OPAL_PHB_CAPI_MODE_PCIE = 0 + OPAL_PHB_CAPI_MODE_CAPI = 1 + OPAL_PHB_CAPI_MODE_SNOOP_OFF = 2 + OPAL_PHB_CAPI_MODE_SNOOP_ON = 3 + OPAL_PHB_CAPI_MODE_DMA = 4 + OPAL_PHB_CAPI_MODE_DMA_TVT1 = 5 Modes `OPAL_PHB_CAPI_MODE_PCIE` and `OPAL_PHB_CAPI_MODE_CAPI` are used to enable/disable CAPP attached to the PHB. @@ -42,8 +59,9 @@ requests maximum number of DMA read engines allocated to improve DMA read performance at cost of reduced bandwidth available to other traffic including CAPP-PSL transactions. -Notes: +Notes ----- + * If PHB is in PEC2 then requesting mode `OPAL_PHB_CAPI_MODE_DMA_TVT1` will allocate extra 16/8 dma read engines to the PHB depending on its stack (stack 0/ stack 1). This is needed to improve the Direct-GPU DMA read @@ -55,20 +73,16 @@ Notes: Return Codes ------------ -OPAL_SUCCESS - Switch to the requested capi mode performed successfully. -OPAL_PARAMETER +:ref:`OPAL_SUCCESS` + Switch to the requested capi mode performed successfully. +:ref:`OPAL_PARAMETER` The requested value of mode or phb_id parameter is not valid. - -OPAL_HARDWARE +:ref:`OPAL_HARDWARE` An error occurred while switching the CAPP to requested mode. - -OPAL_UNSUPPORTED +:ref:`OPAL_UNSUPPORTED` Switching to requested capi mode is not possible at the moment - -OPAL_RESOURCE +:ref:`OPAL_RESOURCE` CAPP ucode not available hence activating CAPP not supported. - -OPAL_BUSY +:ref:`OPAL_BUSY` CAPP is presently in recovery-mode and mode switch cannot be performed. From patchwork Fri May 31 06:12:29 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108083 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZC36rrRz9s00 for ; Fri, 31 May 2019 16:23:27 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZC35zV6zDqXW for ; Fri, 31 May 2019 16:23:27 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0K5z83zDqYd for ; Fri, 31 May 2019 16:14:09 +1000 (AEST) Received: from pps.filterd (m0098419.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V655T7135194 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e33.co.us.ibm.com (e33.co.us.ibm.com [32.97.110.151]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stv224n56-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:06 -0400 Received: from localhost by e33.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:06 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e33.co.us.ibm.com (192.168.1.133) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:03 +0100 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E2Eo27460042 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id ACCCBBE059 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 754F4BE058 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id DA97C503F69; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:29 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0036-0000-0000-00000AC51851 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:04 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0037-0000-0000-00004C021477 Message-Id: <20190531061351.22973-29-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=701 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 028/110] doc: make OPAL_TEST docs pretty X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-test-0.rst | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/doc/opal-api/opal-test-0.rst b/doc/opal-api/opal-test-0.rst index ff56abaa87f6..107f5ce72a45 100644 --- a/doc/opal-api/opal-test-0.rst +++ b/doc/opal-api/opal-test-0.rst @@ -1,12 +1,16 @@ +.. _OPAL_TEST: + OPAL_TEST ========= -OPAL_TEST is a REQUIRED call for OPAL and conforming implementations MUST +:ref:`OPAL_TEST` is a REQUIRED call for OPAL and conforming implementations MUST have it. It is designed to test basic OPAL call functionality. -Token: :: +Token: + +.. code-block:: c #define OPAL_TEST 0 @@ -25,9 +29,11 @@ Returns Function -------- -OPAL_TEST MAY print a string to the OPAL log with the value of argument. +:ref:`OPAL_TEST` MAY print a string to the OPAL log with the value of argument. + +For example, the reference implementation (skiboot) implements :ref:`OPAL_TEST` as: -For example, the reference implementation (skiboot) implements OPAL_TEST as: :: +.. code-block:: c static uint64_t opal_test_func(uint64_t arg) { From patchwork Fri May 31 06:12:30 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108072 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ8X17xwz9s00 for ; Fri, 31 May 2019 16:21:16 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ8X01FDzDqZR for ; Fri, 31 May 2019 16:21:16 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0J3kxzzDqY2 for ; Fri, 31 May 2019 16:14:08 +1000 (AEST) Received: from pps.filterd (m0098404.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64K90042901 for ; Fri, 31 May 2019 02:14:05 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4vhd4s-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:04 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dmxQ006006 for ; Fri, 31 May 2019 02:48:55 GMT Received: from b03cxnp08026.gho.boulder.ibm.com (b03cxnp08026.gho.boulder.ibm.com [9.17.130.18]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9aykb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:55 +0000 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp08026.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E2KR7864796 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B30986A057 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 77E7E6A064 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id DF6AF503F6A; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:30 +1000 Message-Id: <20190531061351.22973-30-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=813 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 029/110] doc: Add anchors to 5.1.13 and 5.3.0 release notes X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/release-notes/skiboot-5.1.13.rst | 2 ++ doc/release-notes/skiboot-5.3.0.rst | 4 +++- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/release-notes/skiboot-5.1.13.rst b/doc/release-notes/skiboot-5.1.13.rst index 122bc1cc8322..28dab2d57f56 100644 --- a/doc/release-notes/skiboot-5.1.13.rst +++ b/doc/release-notes/skiboot-5.1.13.rst @@ -1,3 +1,5 @@ +.. _skiboot-5.1.13: + skiboot-5.1.13 -------------- diff --git a/doc/release-notes/skiboot-5.3.0.rst b/doc/release-notes/skiboot-5.3.0.rst index 78a09864c6f2..5e55c59d45bd 100644 --- a/doc/release-notes/skiboot-5.3.0.rst +++ b/doc/release-notes/skiboot-5.3.0.rst @@ -1,3 +1,5 @@ +.. _skiboot-5.3.0: + skiboot-5.3.0 ------------- @@ -13,4 +15,4 @@ Changes over skiboot-5.3.0-rc2: - Adopt libtool rules for soname versioning for libflash See skiboot-5.3.0-rc2 and skiboot-5.3.0-rc1 release notes for a complete -list of changes from skiboot-5.2.0. +list of changes from skiboot-5.3.0. From patchwork Fri May 31 06:12:31 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108076 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ9N3JPvz9s00 for ; Fri, 31 May 2019 16:22:00 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ9N1vMmzDqYV for ; Fri, 31 May 2019 16:22:00 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0K2h8BzDqY1 for ; Fri, 31 May 2019 16:14:08 +1000 (AEST) Received: from pps.filterd (m0098413.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V68XUG037753 for ; Fri, 31 May 2019 02:14:06 -0400 Received: from e36.co.us.ibm.com (e36.co.us.ibm.com [32.97.110.154]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxr105ns-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:06 -0400 Received: from localhost by e36.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:05 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e36.co.us.ibm.com (192.168.1.136) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:03 +0100 Received: from b03ledav004.gho.boulder.ibm.com (b03ledav004.gho.boulder.ibm.com [9.17.130.235]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E2Ja19530054 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:02 GMT Received: from b03ledav004.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B6F627805C for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b03ledav004.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 7DC1678060 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav004.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id E3CF7503F6B; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:31 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0020-0000-0000-00000EF2737A X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:04 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0021-0000-0000-000066081ED2 Message-Id: <20190531061351.22973-31-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=944 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 030/110] doc: combine OPAL_RTC_READ and OPAL_RTC_WRITE pages X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" One page for Real Time Clock is a bit clearer. Signed-off-by: Stewart Smith --- ...tc-read-3.rst => opal-rtc-read-write-3-4.rst} | 16 ++++++++++++++++ doc/opal-api/opal-rtc-write-4.rst | 11 ----------- 2 files changed, 16 insertions(+), 11 deletions(-) rename doc/opal-api/{opal-rtc-read-3.rst => opal-rtc-read-write-3-4.rst} (83%) delete mode 100644 doc/opal-api/opal-rtc-write-4.rst diff --git a/doc/opal-api/opal-rtc-read-3.rst b/doc/opal-api/opal-rtc-read-write-3-4.rst similarity index 83% rename from doc/opal-api/opal-rtc-read-3.rst rename to doc/opal-api/opal-rtc-read-write-3-4.rst index e2d492f2e0bf..e324e1a3c667 100644 --- a/doc/opal-api/opal-rtc-read-3.rst +++ b/doc/opal-api/opal-rtc-read-write-3-4.rst @@ -1,3 +1,7 @@ +=============================== +OPAL Real Time Clock (RTC) APIs +=============================== + .. _OPAL_RTC_READ: OPAL_RTC_READ @@ -73,3 +77,15 @@ Return codes :ref:`OPAL_BUSY` request may be in flight + +.. _OPAL_RTC_WRITE: + +OPAL_RTC_WRITE +============== + +:ref:`OPAL_RTC_WRITE` is much like :ref:`OPAL_RTC_READ` in that it can be asynchronous. + +If multiple WRITES are issued before the first one completes, subsequent +writes are ignored. There can only be one write in flight at any one time. + +Format of the time is the same as for :ref:`OPAL_RTC_READ`. diff --git a/doc/opal-api/opal-rtc-write-4.rst b/doc/opal-api/opal-rtc-write-4.rst deleted file mode 100644 index c5ef7503bef7..000000000000 --- a/doc/opal-api/opal-rtc-write-4.rst +++ /dev/null @@ -1,11 +0,0 @@ -.. _OPAL_RTC_WRITE: - -OPAL_RTC_WRITE -============== - -:ref:`OPAL_RTC_WRITE` is much like :ref:`OPAL_RTC_READ` in that it can be asynchronous. - -If multiple WRITES are issued before the first one completes, subsequent -writes are ignored. There can only be one write in flight at any one time. - -Format of the time is the same as for :ref:`OPAL_RTC_READ`. From patchwork Fri May 31 06:12:32 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108062 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ4z57Hzz9sB8 for ; Fri, 31 May 2019 16:18:11 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ4z42D3zDqcN for ; Fri, 31 May 2019 16:18:11 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0H5YLrzDqYM for ; Fri, 31 May 2019 16:14:07 +1000 (AEST) Received: from pps.filterd (m0098413.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V68X9n037746 for ; Fri, 31 May 2019 02:14:05 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxr105md-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:05 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dxTx006245 for ; Fri, 31 May 2019 02:48:55 GMT Received: from b01cxnp22036.gho.pok.ibm.com (b01cxnp22036.gho.pok.ibm.com [9.57.198.26]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9aykd-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:55 +0000 Received: from b01ledav004.gho.pok.ibm.com (b01ledav004.gho.pok.ibm.com [9.57.199.109]) by b01cxnp22036.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E39p10748282 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b01ledav004.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id EF1D2112064 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b01ledav004.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id AC674112061 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav004.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id E880F503F6C; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:32 +1000 Message-Id: <20190531061351.22973-32-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 031/110] doc: Make OPAL_CEC_POWER_DOWN docs pretty X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-cec-power-down-5.rst | 37 +++++++++++++++----------- 1 file changed, 22 insertions(+), 15 deletions(-) diff --git a/doc/opal-api/opal-cec-power-down-5.rst b/doc/opal-api/opal-cec-power-down-5.rst index bdcb84e3b958..b4b236e2467c 100644 --- a/doc/opal-api/opal-cec-power-down-5.rst +++ b/doc/opal-api/opal-cec-power-down-5.rst @@ -1,6 +1,9 @@ +.. _OPAL_CEC_POWER_DOWN: + OPAL_CEC_POWER_DOWN =================== -:: + +.. code-block:: c #define OPAL_CEC_POWER_DOWN 5 @@ -8,11 +11,13 @@ OPAL_CEC_POWER_DOWN Arguments --------- -:: - uint64 request values as follows: - 0 - Power down normally - 1 - Power down immediately +`uint64 request` values as follows: + +0 + Power down normally +1 + Power down immediately This OPAL call requests OPAL to power down the system. The exact difference between a normal and immediate shutdown is platform specific. @@ -23,29 +28,31 @@ platform to only support some types of power down operations. Return Values ------------- -``OPAL_SUCCESS`` +:ref:`OPAL_SUCCESS` the power down request was successful. This may/may not result in immediate power down. An OS should - spin in a loop after getting `OPAL_SUCCESS` as it is likely that there + spin in a loop after getting :ref:`OPAL_SUCCESS` as it is likely that there will be a delay before instructions stop being executed. -``OPAL_BUSY`` +:ref:`OPAL_BUSY` unable to power down, try again later. -``OPAL_BUSY_EVENT`` - Unable to power down, call `opal_run_pollers` and try again. +:ref:`OPAL_BUSY_EVENT` + Unable to power down, call :ref:`OPAL_POLL_EVENTS` and try again. -``OPAL_PARAMETER`` +:ref:`OPAL_PARAMETER` a parameter was incorrect -``OPAL_INTERNAL_ERROR`` +:ref:`OPAL_INTERNAL_ERROR` Something went wrong, and waiting and trying again is unlikely to be successful. Although, considering that in a shutdown code path, there's unlikely to be any other valid option to take, retrying is perfectly valid. In older OPAL versions (prior to skiboot v5.9), on IBM FSP systems, this - return code was returned erroneously instead of OPAL_BUSY_EVENT during an + return code was returned erroneously instead of :ref:`OPAL_BUSY_EVENT` during an FSP Reset/Reload. -``OPAL_UNSUPPORTED`` - this platform does not support being powered off. +:ref:`OPAL_UNSUPPORTED` + this platform does not support being powered off. Practically speaking, this + should **never** be returned, but in various simulation or bring-up situations, + it's plausible it is, so code should handle this gracefully. From patchwork Fri May 31 06:12:33 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108074 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ8x6lQ4z9s00 for ; Fri, 31 May 2019 16:21:37 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ8x5nX2zDqbm for ; Fri, 31 May 2019 16:21:37 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0K0fVkzDqXw for ; Fri, 31 May 2019 16:14:08 +1000 (AEST) Received: from pps.filterd (m0098409.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V643H5060029 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e14.ny.us.ibm.com (e14.ny.us.ibm.com [129.33.205.204]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4v99wy-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:06 -0400 Received: from localhost by e14.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:05 +0100 Received: from b01cxnp22034.gho.pok.ibm.com (9.57.198.24) by e14.ny.us.ibm.com (146.89.104.201) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:03 +0100 Received: from b01ledav006.gho.pok.ibm.com (b01ledav006.gho.pok.ibm.com [9.57.199.111]) by b01cxnp22034.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3nC26017894 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b01ledav006.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id F2BF8AC062 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b01ledav006.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B0B31AC059 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav006.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id ECF72503F6D; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:33 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0052-0000-0000-000003C97739 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:04 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0053-0000-0000-0000611BF5E0 Message-Id: <20190531061351.22973-33-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=626 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 032/110] doc: Add example to OPAL_CEC_POWER_DOWN X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-cec-power-down-5.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/doc/opal-api/opal-cec-power-down-5.rst b/doc/opal-api/opal-cec-power-down-5.rst index b4b236e2467c..7a84fce891f9 100644 --- a/doc/opal-api/opal-cec-power-down-5.rst +++ b/doc/opal-api/opal-cec-power-down-5.rst @@ -9,6 +9,24 @@ OPAL_CEC_POWER_DOWN int64 opal_cec_power_down(uint64 request) +As powering down the system is likely an asynchronous operation that we +have to wait for a service processor to do, :ref:`OPAL_CEC_POWER_DOWN` +should be called like the example code below: + +.. code-block:: c + + int rc = OPAL_BUSY; + + do { + rc = opal_cec_power_down(0); + if (rc == OPAL_BUSY_EVENT) + opal_poll_events(NULL); + } while (rc == OPAL_BUSY || rc == OPAL_BUSY_EVENT); + + for (;;) + opal_poll_events(NULL); + + Arguments --------- From patchwork Fri May 31 06:12:34 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108107 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZJx6RWDz9s00 for ; Fri, 31 May 2019 16:28:33 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZJx5PYJzDqK6 for ; Fri, 31 May 2019 16:28:33 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N22ctzDqYM for ; Fri, 31 May 2019 16:14:11 +1000 (AEST) Received: from pps.filterd (m0098404.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64H95042508 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e17.ny.us.ibm.com (e17.ny.us.ibm.com [129.33.205.207]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4vhd6e-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:08 -0400 Received: from localhost by e17.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b01cxnp22035.gho.pok.ibm.com (9.57.198.25) by e17.ny.us.ibm.com (146.89.104.204) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:04 +0100 Received: from b01ledav001.gho.pok.ibm.com (b01ledav001.gho.pok.ibm.com [9.57.199.106]) by b01cxnp22035.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3Np37683282 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 2DEDF28060 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B15992805C for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav001.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id F1959503F6E; Fri, 31 May 2019 16:13:56 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:34 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0040-0000-0000-000004F6E3D1 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:05 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0041-0000-0000-00000902FE9F Message-Id: <20190531061351.22973-34-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 033/110] doc: flesh out OPAL_CEC_REBOOT docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-cec-reboot-6-116.rst | 88 ++++++++++++++++++++++---- 1 file changed, 76 insertions(+), 12 deletions(-) diff --git a/doc/opal-api/opal-cec-reboot-6-116.rst b/doc/opal-api/opal-cec-reboot-6-116.rst index e9e53ce24a95..ba31e7a7a195 100644 --- a/doc/opal-api/opal-cec-reboot-6-116.rst +++ b/doc/opal-api/opal-cec-reboot-6-116.rst @@ -1,21 +1,28 @@ OPAL_CEC_REBOOT and OPAL_CEC_REBOOT2 ==================================== -:: + +.. code-block:: c #define OPAL_CEC_REBOOT 6 #define OPAL_CEC_REBOOT2 116 There are two opal calls to invoke system reboot. -``OPAL_CEC_REBOOT`` - Used for normal reboot by Linux host. +:ref:`OPAL_CEC_REBOOT` + Original reboot call for a normal reboot. + It is recommended to first try :ref:`OPAL_CEC_REBOOT2` + (use :ref:`OPAL_CHECK_TOKEN` first), and then, if not available, + fall back to :ref:`OPAL_CEC_REBOOT`. + All POWER9 systems shipped with support for :ref:`OPAL_CEC_REBOOT2`, + so it is safe to exclusively call the new call if an OS only targets POWER9 + and above. + +:ref:`OPAL_CEC_REBOOT2` + Newer call for rebooting a system, supporting different types of reboots. + For example, the OS may request a reboot due to a platform or OS error, + which may trigger host or BMC firmware to save debugging information. -``OPAL_CEC_REBOOT2`` - Newly introduced to handle abnormal system reboots. - The Linux kernel will make this OPAL call when it has to terminate - abruptly due to an anomalous condition. The kernel will push some system - state context to OPAL, which will in turn push it down to the BMC for - further analysis. +.. _OPAL_CEC_REBOOT: OPAL_CEC_REBOOT --------------- @@ -23,14 +30,52 @@ Syntax: :: int64_t opal_cec_reboot(void) -System reboots normally. +System reboots normally, equivalent to :ref:`OPAL_CEC_REBOOT2`. See +:ref:`OPAL_CEC_REBOOT2` for details, as both OPAL calls should be called +in the same way. + +.. _OPAL_CEC_REBOOT2: OPAL_CEC_REBOOT2 ---------------- -Syntax: :: +Syntax: + +.. code-block:: c int64_t opal_cec_reboot2(uint32_t reboot_type, char *diag) +A reboot call is likely going to involve talking to a service processor to +request a reboot, which can be quite a slow operation. Thus, the correct +way for an OS to make an OPAL reboot call is to spin on :ref:`OPAL_POLL_EVENTS` +to crank any state machine needed for the reboot until the machine reboots +from underneath the OS. + +For example, the below code could be part of an OS calling to do any type +of reboot, and falling back to a normal reboot if that type is not supported. + +.. code-block:: c + + int rc; + int reboot_type = OPAL_REBOOT_NORMAL; + + do { + if (opal_check_token(OPAL_CEC_REBOOT2) == 0) { + rc = opal_cec_reboot2(reboot_type, NULL); + } else { + rc = opal_cec_reboot(); + } + if (rc == OPAL_UNSUPPORTED) { + printf("Falling back to normal reboot\n"); + reboot_type = OPAL_REBOOT_NORMAL; + rc = OPAL_BUSY; + } + opal_poll_events(NULL); + } while (rc == OPAL_BUSY || rc == OPAL_BUSY_EVENT); + + for (;;) + opal_poll_events(NULL); + + Input parameters ^^^^^^^^^^^^^^^^ ``reboot_type`` @@ -40,7 +85,26 @@ Input parameters Null-terminated string. Depending on reboot type, this call will carry out additional steps -before triggering reboot. +before triggering a reboot. + +Return Codes +^^^^^^^^^^^^ + +:ref:`OPAL_SUCCESS` + The system will soon reboot. The OS should loop on :ref:`OPAL_POLL_EVENTS` + in case there's any work for OPAL to do. + +:ref:`OPAL_BUSY` or :ref:`OPAL_BUSY_EVENT` + OPAL is currently busy and can't issue a reboot, call + :ref:`OPAL_POLL_EVENTS` and retry reboot call. + +:ref:`OPAL_UNSUPPORTED` + Unsupported reboot type (applicable to :ref:`OPAL_CEC_REBOOT2` only), retry + with other reboot type. + +Other error codes + Keep calling reboot and hope for the best? In theory this should never happen. + Supported reboot types: ----------------------- From patchwork Fri May 31 06:12:35 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108081 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZBZ197tz9sDX for ; Fri, 31 May 2019 16:23:02 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZBZ0C4jzDqcL for ; Fri, 31 May 2019 16:23:02 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0K4NKgzDqYM for ; Fri, 31 May 2019 16:14:09 +1000 (AEST) Received: from pps.filterd (m0098416.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V643V1019014 for ; Fri, 31 May 2019 02:14:06 -0400 Received: from e11.ny.us.ibm.com (e11.ny.us.ibm.com [129.33.205.201]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stty1pner-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:06 -0400 Received: from localhost by e11.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:05 +0100 Received: from b01cxnp22036.gho.pok.ibm.com (9.57.198.26) by e11.ny.us.ibm.com (146.89.104.198) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:04 +0100 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp22036.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3QP31982048 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 3ECB4B2065 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B8A67B206A for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 02625503F6F; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:35 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-2213-0000-0000-0000039856AD X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:04 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-2214-0000-0000-00005EA4D93B Message-Id: <20190531061351.22973-35-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=892 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 034/110] doc: Flesh out NVRAM docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Reference LoPAPR as where all the requirements come from, and document what the device tree looks like. Signed-off-by: Stewart Smith --- doc/device-tree/ibm,opal/nvram.rst | 13 ++++ doc/opal-api/opal-nvram-read-write-7-8.rst | 72 ++++++++++++++++++---- 2 files changed, 74 insertions(+), 11 deletions(-) create mode 100644 doc/device-tree/ibm,opal/nvram.rst diff --git a/doc/device-tree/ibm,opal/nvram.rst b/doc/device-tree/ibm,opal/nvram.rst new file mode 100644 index 000000000000..e1b432f428db --- /dev/null +++ b/doc/device-tree/ibm,opal/nvram.rst @@ -0,0 +1,13 @@ +.. _device-tree/ibm,opal/nvram: + +nvram Device Tree Node +====================== + +.. code-block:: dts + + nvram { + compatible = "ibm,opal-nvram"; + #bytes = <0x90000>; + }; + +Indicates support (and size of) the :ref:`nvram` facility. diff --git a/doc/opal-api/opal-nvram-read-write-7-8.rst b/doc/opal-api/opal-nvram-read-write-7-8.rst index fe06886bdf9c..54cf30a0cee6 100644 --- a/doc/opal-api/opal-nvram-read-write-7-8.rst +++ b/doc/opal-api/opal-nvram-read-write-7-8.rst @@ -1,13 +1,52 @@ +.. _nvram: + +========== +OPAL NVRAM +========== + +The NVRAM requirements for OPAL systems is derived from LoPAPR, and all +requirements listed in it apply to OPAL with some exceptions. Note that +Section 8.4.1.1.3 "OF Configuration Variables" does NOT apply to OPAL, +neither does 8.4.1.2 "DASD Spin-up Control". Not that the RTAS calls of +`nvram-fetch` and `nvram-store` are roughly equivalent to the +:ref:`OPAL_READ_NVRAM` and :ref:`OPAL_WRITE_NVRAM` calls. + +LoPAPR has a minimum requirement of 8KB of Non-Volatile Memory. While this +requirement carries over, it's important to note that historically all OPAL +systems have had roughly 500kb of NVRAM. + +See :ref:`device-tree/ibm,opal/nvram` for details on how NVRAM is represented +in the device tree. It's fairly simple, it looks like this: + +.. code-block:: dts + + nvram { + compatible = "ibm,opal-nvram"; + #bytes = <0x90000>; + }; + + +.. _OPAL_READ_NVRAM: + OPAL_READ_NVRAM =============== -:: + +.. code-block:: c #define OPAL_READ_NVRAM 7 -``OPAL_READ_NVRAM`` call requests OPAL to read the data from system NVRAM + int64_t opal_read_nvram(uint64_t buffer, uint64_t size, uint64_t offset); + +:ref:`OPAL_READ_NVRAM` call requests OPAL to read the data from system NVRAM memory into a memory buffer. The data at ``offset`` from nvram_image will be copied to memory ``buffer`` of size ``size``. +This is a *synchronous* OPAL call, as OPAL will typically read the content of +NVRAM from its storage (typically flash) during boot, so the call duration +should be along the lines of a ``memcpy()`` operation rather than reading +from storage. + + Parameters ---------- :: @@ -28,23 +67,28 @@ Parameters Return Values ------------- -``OPAL_SUCCESS`` +:ref:`OPAL_SUCCESS` data from nvram to memory ``buffer`` copied successfully -``OPAL_PARAMETER`` +:ref:`OPAL_PARAMETER` a parameter ``offset`` or ``size`` was incorrect -``OPAL_HARDWARE`` +:ref:`OPAL_HARDWARE` either nvram is not initialized or permanent error related to nvram hardware. +.. _OPAL_WRITE_NVRAM: + OPAL_WRITE_NVRAM ================ -:: + +.. code-block:: c #define OPAL_WRITE_NVRAM 8 -``OPAL_WRITE_NVRAM`` call requests OPAL to write the data to actual system NVRAM memory - from memory ``buffer`` at ``offset``, of size ``size`` + int64_t opal_write_nvram(uint64_t buffer, uint64_t size, uint64_t offset); + +:ref:`OPAL_WRITE_NVRAM` call requests OPAL to write the data to actual system NVRAM memory +from memory ``buffer`` at ``offset``, of size ``size`` Parameters ---------- @@ -66,11 +110,17 @@ Parameters Return Values ------------- -``OPAL_SUCCESS`` +:ref:`OPAL_SUCCESS` data from memory ``buffer`` to actual nvram_image copied successfully -``OPAL_PARAMETER`` +:ref:`OPAL_PARAMETER` a parameter ``offset`` or ``size`` was incorrect -``OPAL_HARDWARE`` +:ref:`OPAL_HARDWARE` either nvram is not initialized or permanent error related to nvram hardware. + +:ref:`OPAL_BUSY` + OPAL is currently busy, retry the :ref:`OPAL_WRITE_NVRAM` call. + +:ref:`OPAL_BUSY_EVENT` + OPAL is currently busy, call :ref:`OPAL_POLL_EVENTS` and then retry :ref:`OPAL_WRITE_NVRAM` From patchwork Fri May 31 06:12:36 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108093 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZFS4g06z9sDX for ; Fri, 31 May 2019 16:25:32 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZFS3XNnzDqXt for ; Fri, 31 May 2019 16:25:32 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0L5XtGzDqYp for ; Fri, 31 May 2019 16:14:10 +1000 (AEST) Received: from pps.filterd (m0098410.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V648lU140957 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e32.co.us.ibm.com (e32.co.us.ibm.com [32.97.110.150]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4vsa9p-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e32.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:06 +0100 Received: from b03cxnp08028.gho.boulder.ibm.com (9.17.130.20) by e32.co.us.ibm.com (192.168.1.132) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:03 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp08028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3kT26673518 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id E5108C605F for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B738CC605A for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 06EA1503F70; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:36 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0004-0000-0000-0000151674F6 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:04 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0005-0000-0000-00008BDE979E Message-Id: <20190531061351.22973-36-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=424 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 035/110] doc: Fix up OPAL_HANDLE_INTERRUPT links X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-handle-interrupt.rst | 2 +- doc/overview.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/opal-api/opal-handle-interrupt.rst b/doc/opal-api/opal-handle-interrupt.rst index 73be0e34cfeb..f652af5a373e 100644 --- a/doc/opal-api/opal-handle-interrupt.rst +++ b/doc/opal-api/opal-handle-interrupt.rst @@ -1,4 +1,4 @@ -.. _opal-handle-interrupt: +.. _OPAL_HANDLE_INTERRUPT: OPAL_HANDLE_INTERRUPT ===================== diff --git a/doc/overview.rst b/doc/overview.rst index 3895f67f6edf..aa6489071e82 100644 --- a/doc/overview.rst +++ b/doc/overview.rst @@ -125,7 +125,7 @@ Interrupts We don't directly handle interrupts in skiboot. The OS is in complete control, and any interrupts we need to process are first received by the OS. The -:ref:`opal-handle-interrupt` call is made by the OS for OPAL to do what's +:ref:`OPAL_HANDLE_INTERRUPT` call is made by the OS for OPAL to do what's needed. Memory From patchwork Fri May 31 06:12:37 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108065 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ6Q1tBzz9sB8 for ; Fri, 31 May 2019 16:19:26 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ6P6LXGzDqWw for ; Fri, 31 May 2019 16:19:25 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0J4FdMzDqYS for ; Fri, 31 May 2019 16:14:08 +1000 (AEST) Received: from pps.filterd (m0098409.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V642aB060004 for ; Fri, 31 May 2019 02:14:05 -0400 Received: from e34.co.us.ibm.com (e34.co.us.ibm.com [32.97.110.152]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4v99wh-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:05 -0400 Received: from localhost by e34.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:04 +0100 Received: from b03cxnp08028.gho.boulder.ibm.com (9.17.130.20) by e34.co.us.ibm.com (192.168.1.134) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:04 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp08028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3Xg21955032 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id EFB6EC6061 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B82C3C605B for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 0BBD2503F71; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:37 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0016-0000-0000-000009BC52A2 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:04 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0017-0000-0000-0000436E2D08 Message-Id: <20190531061351.22973-37-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=883 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 036/110] doc: Add details on removed calls X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Fixes: https://github.com/open-power/skiboot/issues/105 Signed-off-by: Stewart Smith --- doc/opal-api/index.rst | 73 ++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 71 insertions(+), 2 deletions(-) diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 5aa259d4ff1f..f17d2f59eef6 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -32,7 +32,10 @@ The OPAL API is the interface between an Operating System and OPAL. +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_POLL_EVENTS` | 10 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_PCI_SET_HUB_TCE_MEMORY` | 11 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_PCI_SET_HUB_TCE_MEMORY` | 11 | N/A | | Was POWER7 | +| | | Present only on | | p5ioc specific. | +| | | internal systems. | | No use outside | +| | | | | IBM development | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_SET_PHB_TCE_MEMORY` | 12 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -52,7 +55,8 @@ The OPAL API is the interface between an Operating System and OPAL. +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_GET_XIVE` | 20 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_GET_COMPLETION_TOKEN_STATUS` | 21 | v1.0 (Initial Release) | POWER8 | /* obsolete */ | +| :ref:`OPAL_GET_COMPLETION_TOKEN_STATUS` | 21 | Never | | Never | +| | | | | Implemented | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_REGISTER_OPAL_EXCEPTION_HANDLER` | 22 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -361,3 +365,68 @@ The OPAL API is the interface between an Operating System and OPAL. * + +Removed Calls +------------- + +Under **very** specific and careful circumstances, an OPAL call has been +removed and no longer supported. + ++---------------------------------------------+-------+-----------------------+-----------------------+ +| Name | API | Introduced | Removed | +| | Token | | | ++---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_GET_COMPLETION_TOKEN_STATUS` | 21 | Never | | ++---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_WRITE_OPPANEL` | 43 | pre-v1.0 | pre-v1.0 | ++---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_OLD_I2C_REQUEST` | 106 | v4.0 | v4.0 | ++---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_PCI_SET_HUB_TCE_MEMORY` | 11 | pre-v1.0 | :ref:`skiboot-5.2.0` | ++---------------------------------------------+-------+-----------------------+-----------------------+ + + +.. _OPAL_GET_COMPLETION_TOKEN_STATUS: + +OPAL_GET_COMPLETION_TOKEN_STATUS +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +In the before time, long-long ago, there existed something called OPAL before +the incarnation we know today. Presumably, this long forgotten incarnation +had a call called this. + +This call has never been implemented, and never will be. + +.. _OPAL_WRITE_OPPANEL: + +OPAL_WRITE_OPPANEL +^^^^^^^^^^^^^^^^^^ + +Never in a released version, use :ref:`OPAL_WRITE_OPPANEL_ASYNC`. + +.. _OPAL_OLD_I2C_REQUEST: + +OPAL_OLD_I2C_REQUEST +^^^^^^^^^^^^^^^^^^^^ + +Never used. Only existing briefly in the :ref:`skiboot-4.0` development cycle. + +.. _OPAL_PCI_SET_HUB_TCE_MEMORY: + +OPAL_PCI_SET_HUB_TCE_MEMORY +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. code-block:: c + + #define OPAL_PCI_SET_HUB_TCE_MEMORY 11 + + int64_t opal_pci_set_hub_tce_memory(uint64_t hub_id, + uint64_t tce_mem_addr __unused, + uint64_t tce_mem_size __unused); + + +Support for POWER7 systems with p5ioc was dropped in :ref:`skiboot-5.2.0`, +and these systems were only ever used with OPAL inside IBM for development +and bring-up purposes. + +Support for p5ioc was removed from the Linux kernel in v4.6-rc1. From patchwork Fri May 31 06:12:38 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108121 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZNJ46xMz9s00 for ; Fri, 31 May 2019 16:31:28 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZNJ35YKzDqcp for ; Fri, 31 May 2019 16:31:28 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N4nlqzDqYV for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098416.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V644dX019058 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e31.co.us.ibm.com (e31.co.us.ibm.com [32.97.110.149]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stty1pnf4-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:08 -0400 Received: from localhost by e31.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:06 +0100 Received: from b03cxnp08028.gho.boulder.ibm.com (9.17.130.20) by e31.co.us.ibm.com (192.168.1.131) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:04 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp08028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3cI30867838 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 031F6C6062 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id BE12DC605D for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 1097C503F74; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:38 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-8235-0000-0000-00000EA0F3A6 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:04 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-8236-0000-0000-000045C9C0E9 Message-Id: <20190531061351.22973-38-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 037/110] Remove remnants of OPAL_PCI_SET_PHB_TCE_MEMORY X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" There's no reason we need remnants hanging around that aren't used, so remove them and save a handful of bytes at runtime. Simultaneously, document the OPAL call removal. Signed-off-by: Stewart Smith --- core/pci-opal.c | 12 +++--------- doc/opal-api/index.rst | 32 ++++++++++++++++++++++++++++++-- include/pci.h | 6 ------ 3 files changed, 33 insertions(+), 17 deletions(-) diff --git a/core/pci-opal.c b/core/pci-opal.c index d7abb15b2bad..a52b02a9d845 100644 --- a/core/pci-opal.c +++ b/core/pci-opal.c @@ -861,21 +861,15 @@ static int64_t opal_pci_set_power_state(uint64_t async_token, opal_call(OPAL_PCI_SET_POWER_STATE, opal_pci_set_power_state, 3); static int64_t opal_pci_set_phb_tce_memory(uint64_t phb_id, - uint64_t tce_mem_addr, - uint64_t tce_mem_size) + uint64_t tce_mem_addr __unused, + uint64_t tce_mem_size __unused) { struct phb *phb = pci_get_phb(phb_id); - int64_t rc; if (!phb) return OPAL_PARAMETER; - if (!phb->ops->set_phb_tce_memory) - return OPAL_UNSUPPORTED; - phb_lock(phb); - rc = phb->ops->set_phb_tce_memory(phb, tce_mem_addr, tce_mem_size); - phb_unlock(phb); - return rc; + return OPAL_UNSUPPORTED; } opal_call(OPAL_PCI_SET_PHB_TCE_MEMORY, opal_pci_set_phb_tce_memory, 3); diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index f17d2f59eef6..65dcf10a870f 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -37,7 +37,10 @@ The OPAL API is the interface between an Operating System and OPAL. | | | internal systems. | | No use outside | | | | | | IBM development | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_PCI_SET_PHB_TCE_MEMORY` | 12 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_PCI_SET_PHB_TCE_MEMORY` | 12 | N/A | | Was POWER7 | +| | | Present only on | | p5ioc specific. | +| | | internal systems. | | No use outside | +| | | | | IBM development | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_CONFIG_READ_BYTE` | 13 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -384,7 +387,8 @@ removed and no longer supported. +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_SET_HUB_TCE_MEMORY` | 11 | pre-v1.0 | :ref:`skiboot-5.2.0` | +---------------------------------------------+-------+-----------------------+-----------------------+ - +| :ref:`OPAL_PCI_SET_PHB_TCE_MEMORY` | 12 | pre-v1.0 | :ref:`skiboot-5.2.0` | ++---------------------------------------------+-------+-----------------------+-----------------------+ .. _OPAL_GET_COMPLETION_TOKEN_STATUS: @@ -424,6 +428,30 @@ OPAL_PCI_SET_HUB_TCE_MEMORY uint64_t tce_mem_addr __unused, uint64_t tce_mem_size __unused); +This call was only ever relevant for p5ioc based POWER7 systems. These were +never available with OPAL outside of IBM development. + +Support for POWER7 systems with p5ioc was dropped in :ref:`skiboot-5.2.0`, +and these systems were only ever used with OPAL inside IBM for development +and bring-up purposes. + +Support for p5ioc was removed from the Linux kernel in v4.6-rc1. + +.. _OPAL_PCI_SET_PHB_TCE_MEMORY: + +OPAL_PCI_SET_PHB_TCE_MEMORY +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. code-block:: c + + #define OPAL_PCI_SET_PHB_TCE_MEMORY 12 + + int64_t opal_pci_set_phb_tce_memory(uint64_t phb_id, + uint64_t tce_mem_addr, + uint64_t tce_mem_size); + +This call was only ever relevant for p5ioc based POWER7 systems. These were +never available with OPAL outside of IBM development. Support for POWER7 systems with p5ioc was dropped in :ref:`skiboot-5.2.0`, and these systems were only ever used with OPAL inside IBM for development diff --git a/include/pci.h b/include/pci.h index b49641ca17a5..cf06dc36b723 100644 --- a/include/pci.h +++ b/include/pci.h @@ -336,12 +336,6 @@ struct phb_ops { int64_t (*papr_errinjct_reset)(struct phb *phb); - /* - * P5IOC2 only - */ - int64_t (*set_phb_tce_memory)(struct phb *phb, uint64_t tce_mem_addr, - uint64_t tce_mem_size); - /* * IODA2 PCI interfaces */ From patchwork Fri May 31 06:12:39 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108067 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ7M0DW8z9s00 for ; Fri, 31 May 2019 16:20:15 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ7L6D78zDqXW for ; Fri, 31 May 2019 16:20:14 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0J4ndQzDqY0 for ; Fri, 31 May 2019 16:14:08 +1000 (AEST) Received: from pps.filterd (m0098394.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64If4078432 for ; Fri, 31 May 2019 02:14:06 -0400 Received: from e35.co.us.ibm.com (e35.co.us.ibm.com [32.97.110.153]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stv42d06f-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:05 -0400 Received: from localhost by e35.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:05 +0100 Received: from b03cxnp08027.gho.boulder.ibm.com (9.17.130.19) by e35.co.us.ibm.com (192.168.1.135) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:04 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp08027.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3bX29294888 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 09A866A04F for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id C6A386A047 for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 1499E503F76; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:39 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0012-0000-0000-0000173DDCF9 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:05 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0013-0000-0000-00005778F805 Message-Id: <20190531061351.22973-39-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 038/110] Remove last remnants of OPAL_PCI_SET_PHB_TCE_MEMORY and OPAL_PCI_SET_HUB_TCE_MEMORY X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Since we have not supported p5ioc systems since skiboot 5.2, it's pretty safe to just wholesale remove these OPAL calls now. Signed-off-by: Stewart Smith Reviewed-by: Andrew Donnellan --- core/pci-opal.c | 13 ------------- hw/cec.c | 14 -------------- include/opal-api.h | 4 ++-- 3 files changed, 2 insertions(+), 29 deletions(-) diff --git a/core/pci-opal.c b/core/pci-opal.c index a52b02a9d845..08883949e629 100644 --- a/core/pci-opal.c +++ b/core/pci-opal.c @@ -860,19 +860,6 @@ static int64_t opal_pci_set_power_state(uint64_t async_token, } opal_call(OPAL_PCI_SET_POWER_STATE, opal_pci_set_power_state, 3); -static int64_t opal_pci_set_phb_tce_memory(uint64_t phb_id, - uint64_t tce_mem_addr __unused, - uint64_t tce_mem_size __unused) -{ - struct phb *phb = pci_get_phb(phb_id); - - if (!phb) - return OPAL_PARAMETER; - - return OPAL_UNSUPPORTED; -} -opal_call(OPAL_PCI_SET_PHB_TCE_MEMORY, opal_pci_set_phb_tce_memory, 3); - static int64_t opal_pci_get_phb_diag_data(uint64_t phb_id, void *diag_buffer, uint64_t diag_buffer_len) diff --git a/hw/cec.c b/hw/cec.c index 887a0672c0a5..5f1e658c9a7d 100644 --- a/hw/cec.c +++ b/hw/cec.c @@ -52,20 +52,6 @@ void cec_reset(void) } } -/* This was only supported by p5ioc, which was dropped */ -static int64_t opal_pci_set_hub_tce_memory(uint64_t hub_id, - uint64_t tce_mem_addr __unused, - uint64_t tce_mem_size __unused) -{ - struct io_hub *hub = cec_get_hub_by_id(hub_id); - - if (!hub) - return OPAL_PARAMETER; - - return OPAL_UNSUPPORTED; -} -opal_call(OPAL_PCI_SET_HUB_TCE_MEMORY, opal_pci_set_hub_tce_memory, 3); - static int64_t opal_pci_get_hub_diag_data(uint64_t hub_id, void *diag_buffer, uint64_t diag_buffer_len) diff --git a/include/opal-api.h b/include/opal-api.h index b0ad435539fb..535cca88f5c2 100644 --- a/include/opal-api.h +++ b/include/opal-api.h @@ -70,8 +70,8 @@ #define OPAL_WRITE_NVRAM 8 #define OPAL_HANDLE_INTERRUPT 9 #define OPAL_POLL_EVENTS 10 -#define OPAL_PCI_SET_HUB_TCE_MEMORY 11 -#define OPAL_PCI_SET_PHB_TCE_MEMORY 12 +#define OPAL_PCI_SET_HUB_TCE_MEMORY 11 /* Removed, p5ioc only */ +#define OPAL_PCI_SET_PHB_TCE_MEMORY 12 /* Removed, p5ioc only */ #define OPAL_PCI_CONFIG_READ_BYTE 13 #define OPAL_PCI_CONFIG_READ_HALF_WORD 14 #define OPAL_PCI_CONFIG_READ_WORD 15 From patchwork Fri May 31 06:12:40 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108082 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZBn1z7zz9s00 for ; Fri, 31 May 2019 16:23:13 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZBn0f7VzDqYM for ; Fri, 31 May 2019 16:23:13 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0K3y39zDqYb for ; Fri, 31 May 2019 16:14:09 +1000 (AEST) Received: from pps.filterd (m0098417.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V66A9x145251 for ; Fri, 31 May 2019 02:14:06 -0400 Received: from e11.ny.us.ibm.com (e11.ny.us.ibm.com [129.33.205.201]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvp63v0f-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:06 -0400 Received: from localhost by e11.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:05 +0100 Received: from b01cxnp22035.gho.pok.ibm.com (9.57.198.25) by e11.ny.us.ibm.com (146.89.104.198) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:04 +0100 Received: from b01ledav001.gho.pok.ibm.com (b01ledav001.gho.pok.ibm.com [9.57.199.106]) by b01cxnp22035.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3jd34472068 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 429822805A for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 0A03628058 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav001.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:02 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 198FC503F79; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:40 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-2213-0000-0000-0000039856AE X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:04 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-2214-0000-0000-00005EA4D93C Message-Id: <20190531061351.22973-40-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=970 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 039/110] doc: Add PCI Config Space OPAL call docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- ...ci-config-read-write-13-14-15-16-17-18.rst | 132 ++++++++++++++++++ 1 file changed, 132 insertions(+) create mode 100644 doc/opal-api/opal-pci-config-read-write-13-14-15-16-17-18.rst diff --git a/doc/opal-api/opal-pci-config-read-write-13-14-15-16-17-18.rst b/doc/opal-api/opal-pci-config-read-write-13-14-15-16-17-18.rst new file mode 100644 index 000000000000..8fbb116a4f47 --- /dev/null +++ b/doc/opal-api/opal-pci-config-read-write-13-14-15-16-17-18.rst @@ -0,0 +1,132 @@ + +.. _OPAL_PCI_CONFIG: + +============================ +OPAL PCI Config Space Access +============================ + +PCI Config space is read or written to through OPAL calls. All of these calls + +.. _OPAL_PCI_CONFIG_return_codes: + +OPAL_PCI_CONFIG_* Return codes +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +:ref:`OPAL_SUCCESS` + Read/Write operation completed successfully. +:ref:`OPAL_PARAMETER` + Invalid parameter. e.g. invalid `phb_id` or `bus_dev_func`. +:ref:`OPAL_HARDWARE` + Invalid request for the hardware either permanently or in its + current state. Can also be a hardware problem, e.g. fenced or + config access is currently blocked. +:ref:`OPAL_UNSUPPORTED` + Unsupported operation. For example, phb4 doesn't support ASB config + space writes. +Other return codes + Should be handled gracefully. For example, for any return code other than + :ref:`OPAL_SUCCESS`, Linux will return all bits set for the specified size + for a read, and will ignore the error on a write. + +.. _OPAL_PCI_CONFIG_READ_BYTE: + +OPAL_PCI_CONFIG_READ_BYTE +------------------------- + +.. code-block:: c + + #define OPAL_PCI_CONFIG_READ_BYTE 13 + + int64_t opal_pci_config_read_byte(uint64_t phb_id, + uint64_t bus_dev_func, + uint64_t offset, + uint8_t *data); + +Reads a single byte from PCI config space, +see :ref:`OPAL_PCI_CONFIG_return_codes`. + +.. _OPAL_PCI_CONFIG_READ_HALF_WORD: + +OPAL_PCI_CONFIG_READ_HALF_WORD +------------------------------ + +.. code-block:: c + + #define OPAL_PCI_CONFIG_READ_HALF_WORD 14 + + int64_t opal_pci_config_read_half_word(uint64_t phb_id, + uint64_t bus_dev_func, + uint64_t offset, + uint16_t *data); + +Reads a half word (16 bits) from PCI config space, +see :ref:`OPAL_PCI_CONFIG_return_codes`. + +.. _OPAL_PCI_CONFIG_READ_WORD: + +OPAL_PCI_CONFIG_READ_WORD +------------------------- + +.. code-block:: c + + #define OPAL_PCI_CONFIG_READ_WORD 15 + + int64_t opal_pci_config_read_word(uint64_t phb_id, + uint64_t bus_dev_func, + uint64_t offset, + uint32_t *data); + +Reads a word (32 bits) from PCI config space, +see :ref:`OPAL_PCI_CONFIG_return_codes`. + +.. _OPAL_PCI_CONFIG_WRITE_BYTE: + +OPAL_PCI_CONFIG_WRITE_BYTE +-------------------------- + +.. code-block:: c + + #define OPAL_PCI_CONFIG_WRITE_BYTE 16 + + int64_t opal_pci_config_write_byte(uint64_t phb_id, + uint64_t bus_dev_func, + uint64_t offset, + uint8_t data); + +Writes a byte (8 bits) to PCI config space, +see :ref:`OPAL_PCI_CONFIG_return_codes`. + +.. _OPAL_PCI_CONFIG_WRITE_HALF_WORD: + +OPAL_PCI_CONFIG_WRITE_HALF_WORD +------------------------------- + +.. code-block:: c + + #define OPAL_PCI_CONFIG_WRITE_HALF_WORD 17 + + int64_t opal_pci_config_read_half_word(uint64_t phb_id, + uint64_t bus_dev_func, + uint64_t offset, + uint16_t data); + +Writes a half word (16 bits) to PCI config space, +see :ref:`OPAL_PCI_CONFIG_return_codes`. + +.. _OPAL_PCI_CONFIG_WRITE_WORD: + +OPAL_PCI_CONFIG_WRITE_WORD +-------------------------- + +.. code-block:: c + + #define OPAL_PCI_CONFIG_WRITE_WORD 18 + + int64_t opal_pci_config_read_word(uint64_t phb_id, + uint64_t bus_dev_func, + uint64_t offset, + uint32_t data); + +Writes a word (32 bits) to PCI config space, +see :ref:`OPAL_PCI_CONFIG_return_codes`. + From patchwork Fri May 31 06:12:41 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108088 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZD92q32z9s00 for ; Fri, 31 May 2019 16:24:25 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZD91ftpzDqX0 for ; Fri, 31 May 2019 16:24:25 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0L1BqyzDqYV for ; Fri, 31 May 2019 16:14:09 +1000 (AEST) Received: from pps.filterd (m0098396.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V644DW037727 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e17.ny.us.ibm.com (e17.ny.us.ibm.com [129.33.205.207]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4v1d4j-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e17.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:05 +0100 Received: from b01cxnp22036.gho.pok.ibm.com (9.57.198.26) by e17.ny.us.ibm.com (146.89.104.204) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:04 +0100 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp22036.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3sp32833962 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 57FBEB2067 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 10A18B205F for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 1DB98503F7C; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:41 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0040-0000-0000-000004F6E3D0 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:05 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0041-0000-0000-00000902FEA0 Message-Id: <20190531061351.22973-41-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=985 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 040/110] doc: Make OPAL_ELOG_* pretty, mark OPAL_ELOG_WRITE unimplemented X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/index.rst | 3 +- doc/opal-api/opal-elog-71-72-73-74-75.rst | 52 ++++++++++++++--------- 2 files changed, 34 insertions(+), 21 deletions(-) diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 65dcf10a870f..003014fb9703 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -155,7 +155,8 @@ The OPAL API is the interface between an Operating System and OPAL. +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_ELOG_READ` | 71 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_ELOG_WRITE` | 72 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_ELOG_WRITE` | 72 | N/A | | Currently | +| | | | | unused. | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_ELOG_ACK` | 73 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ diff --git a/doc/opal-api/opal-elog-71-72-73-74-75.rst b/doc/opal-api/opal-elog-71-72-73-74-75.rst index 1e5212b5a34f..0326e284bf07 100644 --- a/doc/opal-api/opal-elog-71-72-73-74-75.rst +++ b/doc/opal-api/opal-elog-71-72-73-74-75.rst @@ -1,3 +1,5 @@ +.. _OPAL_ELOG: + OPAL_ELOG: Error logging ======================== @@ -8,7 +10,9 @@ by the service processor or OPAL in reaction to certain events. For example, an IPL failure could be recorded in an error log, as could the reason and details of an unexpected shut-down/reboot (e.g. hard thermal limits, check-stop). -There are five OPAL calls from host to OPAL on error log: :: +There are five OPAL calls from host to OPAL on error log: + +.. code-block:: c #define OPAL_ELOG_READ 71 #define OPAL_ELOG_WRITE 72 @@ -16,21 +20,26 @@ There are five OPAL calls from host to OPAL on error log: :: #define OPAL_ELOG_RESEND 74 #define OPAL_ELOG_SIZE 75 -Note: ``OPAL_ELOG_WRITE`` (72) Unused for now, can be used in future. +.. _OPAL_ELOG_WRITE: + +Note: :ref:`OPAL_ELOG_WRITE` (72) Unused for now, might be supported in the +future. Not all platforms support these calls, so it's important for a host Operating -System to use the OPAL_CHECK_TOKEN call first. If ``OPAL_ELOG_READ``, -``OPAL_ELOG_ACK``, ``OPAL_ELOG_RESEND``, or ``OPAL_ELOG_SIZE`` is present, -then the rest of that group is also present. The presence of ``OPAL_ELOG_WRITE`` +System to use the :ref:`OPAL_CHECK_TOKEN` call first. If :ref:`OPAL_ELOG_READ`, +:ref:`OPAL_ELOG_ACK`, :ref:`OPAL_ELOG_RESEND`, or :ref:`OPAL_ELOG_SIZE` is present, +then the rest of that group is also present. The presence of :ref:`OPAL_ELOG_WRITE` must be checked separately. **TODO**: we need a good explanation of the notification mechanism and in what order and *when* to call each of the OPAL APIs. +.. _OPAL_ELOG_READ: + OPAL_ELOG_READ -------------- -The ``OPAL_ELOG_READ`` call will copy the error log identified by ``id`` into +The :ref:`OPAL_ELOG_READ` call will copy the error log identified by ``id`` into the ``buffer`` of size ``size``. ``OPAL_ELOG_READ`` accepts 3 parameters: :: @@ -41,18 +50,20 @@ the ``buffer`` of size ``size``. Returns: -``OPAL_WRONG_STATE`` +:ref:`OPAL_WRONG_STATE` When there are no error logs to read, or ``OPAL_ELOG`` calls are done in the wrong order. -``OPAL_PARAMETER`` +:ref:`OPAL_PARAMETER` The ``id`` does not match the log id that is available. -``OPAL_SUCCESS`` +:ref:`OPAL_SUCCESS` Error log is copied to ``buffer``. Other generic OPAL error codes may also be returned and should be treated -like ``OPAL_INTERNAL_ERROR``. +like :ref:`OPAL_INTERNAL_ERROR`. + +.. _OPAL_ELOG_ACK: OPAL_ELOG_ACK ------------- @@ -62,43 +73,44 @@ the host operating system has dealt with the error log successfully. This allows OPAL and the service processor to delete the error log from their memory/storage. -``OPAL_ELOG_ACK`` accepts 1 parameter: :: +:ref:`OPAL_ELOG_ACK` accepts 1 parameter: :: uint64_t ack_id Returns: -``OPAL_INTERNAL_ERROR`` +:ref:`OPAL_INTERNAL_ERROR` OPAL failed to send acknowledgement to the error log creator. - -``OPAL_SUCCESS`` +:ref:`OPAL_SUCCESS` Success! Other generic OPAL error codes may also be returned, and should be treated -like ``OPAL_INTERNAL_ERROR``. +like :ref:`OPAL_INTERNAL_ERROR`. +.. _OPAL_ELOG_RESEND: OPAL_ELOG_RESEND ---------------- -The ``OPAL_ELOG_RESEND`` call will cause OPAL to resend notification to the +The :ref:`OPAL_ELOG_RESEND` call will cause OPAL to resend notification to the host operating system of all outstanding error logs. This is commonly used (although doesn't have to be) in a kexec scenario. The call registered with this token accepts no parameter and returns type is void. +.. _OPAL_ELOG_SIZE: OPAL_ELOG_SIZE -------------- -The ``OPAL_ELOG_SIZE`` call retrieves information about an error log. +The :ref:`OPAL_ELOG_SIZE` call retrieves information about an error log. Here, ``type`` specifies error log format. Supported types are : :: 0 -> Platform Error Log -``OPAL_ELOG_SIZE`` accepts 3 parameters: :: +:ref:`OPAL_ELOG_SIZE` accepts 3 parameters: :: uint64_t *elog_id uint64_t *elog_size @@ -106,10 +118,10 @@ Here, ``type`` specifies error log format. Supported types are : :: Returns: -``OPAL_WRONG_STATE`` +:ref:`OPAL_WRONG_STATE` There is no error log to fetch information about. -``OPAL_SUCCESS`` +:ref:`OPAL_SUCCESS` Success. Other general OPAL errors may be returned. From patchwork Fri May 31 06:12:42 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108085 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZCV3GzVz9s00 for ; Fri, 31 May 2019 16:23:50 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZCV2J5gzDqcS for ; Fri, 31 May 2019 16:23:50 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0K65THzDqYB for ; Fri, 31 May 2019 16:14:09 +1000 (AEST) Received: from pps.filterd (m0098393.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64E4p076135 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e31.co.us.ibm.com (e31.co.us.ibm.com [32.97.110.149]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvha4a4s-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e31.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:06 +0100 Received: from b03cxnp08026.gho.boulder.ibm.com (9.17.130.18) by e31.co.us.ibm.com (192.168.1.131) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:04 +0100 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp08026.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3YC7864800 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 48E2BBE05B for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 11C68BE058 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 22978503F7E; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:42 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-8235-0000-0000-00000EA0F3A8 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:05 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-8236-0000-0000-000045C9C0EB Message-Id: <20190531061351.22973-42-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 041/110] Document the long removed OPAL_REGISTER_OPAL_EXCEPTION_HANDLER call X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" I'm pretty sure this was removed in one of our first ever service packs. Fixes: https://github.com/open-power/skiboot/issues/98 Signed-off-by: Stewart Smith --- doc/opal-api/index.rst | 34 +++++++++++++++++++++++++++++++++- 1 file changed, 33 insertions(+), 1 deletion(-) diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 003014fb9703..98fedee9f723 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -61,7 +61,7 @@ The OPAL API is the interface between an Operating System and OPAL. | :ref:`OPAL_GET_COMPLETION_TOKEN_STATUS` | 21 | Never | | Never | | | | | | Implemented | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_REGISTER_OPAL_EXCEPTION_HANDLER` | 22 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_REGISTER_OPAL_EXCEPTION_HANDLER` | 22 | v1.0 (Initial Release) | | Removed | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_EEH_FREEZE_STATUS` | 23 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -386,6 +386,8 @@ removed and no longer supported. +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_OLD_I2C_REQUEST` | 106 | v4.0 | v4.0 | +---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_REGISTER_OPAL_EXCEPTION_HANDLER` | 22 | v1.0 Initial Release | :ref:`skiboot-5.0` | ++---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_SET_HUB_TCE_MEMORY` | 11 | pre-v1.0 | :ref:`skiboot-5.2.0` | +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_SET_PHB_TCE_MEMORY` | 12 | pre-v1.0 | :ref:`skiboot-5.2.0` | @@ -416,6 +418,36 @@ OPAL_OLD_I2C_REQUEST Never used. Only existing briefly in the :ref:`skiboot-4.0` development cycle. + +.. _OPAL_REGISTER_OPAL_EXCEPTION_HANDLER: + +OPAL_REGISTER_OPAL_EXCEPTION_HANDLER +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. code-block:: c + + #define OPAL_REGISTER_OPAL_EXCEPTION_HANDLER 22 + + + int64_t opal_register_exc_handler(uint64_t opal_exception __unused, + uint64_t handler_address __unused, + uint64_t glue_cache_line __unused); + + +This call existed for a very short period of time and only ever worked with Big +Endian host operating systems. The idea was that OPAL would handle HMIs and +an OS could (if it chose to) register a handler for them. This call is not +required since the introduction of :ref:`OPAL_HANDLE_HMI` and all machines that +ever shipped without :ref:`OPAL_HANDLE_HMI` have a firmware update that +supports it. For IBM Tuleta machines, this was FW810.20 (released Oct 2014) +that had :ref:`OPAL_HANDLE_HMI` support. + +This call was removed in :ref:`skiboot-5.0` and now just +returns :ref:`OPAL_UNSUPPORTED`. + +Use of the :ref:`OPAL_HANDLE_HMI` call was introduced in Linux 3.17. + + .. _OPAL_PCI_SET_HUB_TCE_MEMORY: OPAL_PCI_SET_HUB_TCE_MEMORY From patchwork Fri May 31 06:12:43 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108103 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZHt1qQgz9s00 for ; Fri, 31 May 2019 16:27:38 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZHt0rNWzDqcp for ; Fri, 31 May 2019 16:27:38 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N1bpbzDqY2 for ; Fri, 31 May 2019 16:14:11 +1000 (AEST) Received: from pps.filterd (m0098394.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64KrW078616 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e34.co.us.ibm.com (e34.co.us.ibm.com [32.97.110.152]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stv42d07j-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e34.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b03cxnp08027.gho.boulder.ibm.com (9.17.130.19) by e34.co.us.ibm.com (192.168.1.134) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:04 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp08027.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3ij9044352 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 4E3DB6A051 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 16B526A057 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 297B4503F80; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:43 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0016-0000-0000-000009BC52A3 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:05 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0017-0000-0000-0000436E2D09 Message-Id: <20190531061351.22973-43-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=629 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 042/110] doc: fix OPAL_CONSOLE_* links X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-console-read-write-1-2.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/doc/opal-api/opal-console-read-write-1-2.rst b/doc/opal-api/opal-console-read-write-1-2.rst index 60cd0a6dd06f..ef71a6aa72be 100644 --- a/doc/opal-api/opal-console-read-write-1-2.rst +++ b/doc/opal-api/opal-console-read-write-1-2.rst @@ -48,6 +48,8 @@ Returns: A conforming implementation SHOULD try to NOT do partial writes, although partial writes and not writing anything are valid. +.. _OPAL_CONSOLE_WRITE_BUFFER_SPACE: + OPAL_CONSOLE_WRITE_BUFFER_SPACE ------------------------------- @@ -84,6 +86,8 @@ Returns: Use :ref:`OPAL_POLL_EVENTS` for how to determine +.. _OPAL_CONSOLE_FLUSH: + OPAL_CONSOLE_FLUSH ------------------ From patchwork Fri May 31 06:12:44 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108119 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZN44Cq9z9s00 for ; Fri, 31 May 2019 16:31:16 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZN43LrQzDqfd for ; Fri, 31 May 2019 16:31:16 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N4rcxzDqZ9 for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098420.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V6AxAX086853 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e36.co.us.ibm.com (e36.co.us.ibm.com [32.97.110.154]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxsbg1tn-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e36.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b03cxnp08026.gho.boulder.ibm.com (9.17.130.18) by e36.co.us.ibm.com (192.168.1.136) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:04 +0100 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp08026.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3Yo11469082 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 52FFABE05D for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 19844BE053 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 2BFE2503F82; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:44 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0020-0000-0000-00000EF2737B X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:05 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0021-0000-0000-000066081ED3 Message-Id: <20190531061351.22973-44-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=870 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 043/110] doc: OPAL_START_CPU and OPAL_RETURN_CPU X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Fixes: https://github.com/open-power/skiboot/issues/103 Signed-off-by: Stewart Smith --- doc/opal-api/opal-return-cpu-69.rst | 19 ------- doc/opal-api/opal-start-return-cpu-41-69.rst | 57 ++++++++++++++++++++ 2 files changed, 57 insertions(+), 19 deletions(-) delete mode 100644 doc/opal-api/opal-return-cpu-69.rst create mode 100644 doc/opal-api/opal-start-return-cpu-41-69.rst diff --git a/doc/opal-api/opal-return-cpu-69.rst b/doc/opal-api/opal-return-cpu-69.rst deleted file mode 100644 index 4a9631c8778f..000000000000 --- a/doc/opal-api/opal-return-cpu-69.rst +++ /dev/null @@ -1,19 +0,0 @@ -OPAL_RETURN_CPU -=============== -:: - - int64_t opal_return_cpu(void); - -When OPAL first starts the host, all secondary CPUs are spinning in OPAL. -To start them, one must call OPAL_START_CPU (you may want to OPAL_REINIT_CPUS -to set the HILE bit first). - -In cases where you need OPAL to do something for you across all CPUs, such -as OPAL_REINIT_CPUS, (on some platforms) a firmware update or get the machine -back into a similar state as to when the host OS was started (e.g. for kexec) -you may also need to return control of the CPU to OPAL. - - -Returns -------- -This call does **not return**. You need to OPAL_START_CPU. diff --git a/doc/opal-api/opal-start-return-cpu-41-69.rst b/doc/opal-api/opal-start-return-cpu-41-69.rst new file mode 100644 index 000000000000..7bb73a769d28 --- /dev/null +++ b/doc/opal-api/opal-start-return-cpu-41-69.rst @@ -0,0 +1,57 @@ +==================================== +Starting and stopping secondary CPUs +==================================== + +In this context, each thread is a CPU. That is, you start and stop threads of +CPUs. + +.. _OPAL_START_CPU: + +OPAL_START_CPU +============== + +.. code-block:: c + + #define OPAL_START_CPU 41 + + int64_t opal_start_cpu_thread(uint64_t server_no, uint64_t start_address); + +Returns +------- + +:ref:`OPAL_SUCCESS` + The CPU was instructed to start executing instructions from the specified + `start_address`. + This is an *asynchronous* operation, so it may take a short period of + time before the CPU actually starts at that address. +:ref:`OPAL_PARAMETER` + Invalid CPU. +:ref:`OPAL_WRONG_STATE` + If the CPU thread is not in OPAL, or is being re-initialized through :ref:`OPAL_REINIT_CPUS` +:ref:`OPAL_INTERNAL_ERROR` + Something else went horribly wrong. + +.. _OPAL_RETURN_CPU: + +OPAL_RETURN_CPU +=============== + +.. code-block:: c + + #define OPAL_RETURN_CPU 69 + + int64_t opal_return_cpu(void); + +When OPAL first starts the host, all secondary CPUs are spinning in OPAL. +To start them, one must call OPAL_START_CPU (you may want to OPAL_REINIT_CPUS +to set the HILE bit first). + +In cases where you need OPAL to do something for you across all CPUs, such +as OPAL_REINIT_CPUS, (on some platforms) a firmware update or get the machine +back into a similar state as to when the host OS was started (e.g. for kexec) +you may also need to return control of the CPU to OPAL. + + +Returns +------- +This call does **not return**. You need to OPAL_START_CPU. From patchwork Fri May 31 06:12:45 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108068 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZ7c2m5Nz9s00 for ; Fri, 31 May 2019 16:20:28 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZ7c1n4szDqXW for ; Fri, 31 May 2019 16:20:28 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0J3krNzDqXv for ; Fri, 31 May 2019 16:14:08 +1000 (AEST) Received: from pps.filterd (m0098394.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64Gq5078264 for ; Fri, 31 May 2019 02:14:05 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stv42d067-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:05 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dbKj005901 for ; Fri, 31 May 2019 02:48:56 GMT Received: from b03cxnp08026.gho.boulder.ibm.com (b03cxnp08026.gho.boulder.ibm.com [9.17.130.18]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9ayke-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:56 +0000 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp08026.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3tZ27787598 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 525B7BE059 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 1F7D3BE056 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 30E43503F85; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:45 +1000 Message-Id: <20190531061351.22973-45-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=3 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 044/110] doc: Add links to XIVE calls X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/xive.rst | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/doc/xive.rst b/doc/xive.rst index fe7c737df63c..3a8f2203fdfc 100644 --- a/doc/xive.rst +++ b/doc/xive.rst @@ -271,6 +271,8 @@ IV - OPAL APIs These aren't fully specified (yet) but common sense shall apply. +.. _OPAL_XIVE_RESET: + OPAL_XIVE_RESET ^^^^^^^^^^^^^^^ .. code-block:: c @@ -309,6 +311,8 @@ first. inside OPAL and as such is not suitable to be performed during normal runtime. +.. _OPAL_XIVE_GET_IRQ_INFO: + OPAL_XIVE_GET_IRQ_INFO ^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: c @@ -385,6 +389,8 @@ OPAL_BUSY. the OS to use that to pick up a default target processor on the same chip. +.. _OPAL_XIVE_EOI: + OPAL_XIVE_EOI ^^^^^^^^^^^^^ @@ -403,6 +409,8 @@ is preferred. whether OPAL is in XICS emulation mode or native XIVE exploitation mode. +.. _OPAL_XIVE_GET_IRQ_CONFIG: + OPAL_XIVE_GET_IRQ_CONFIG ^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: c @@ -427,6 +435,8 @@ interrupt number (the number that will be presented in the queue). * out_lirq: Will contain the logical interrupt assigned to the interrupt. By default this will be the same as girq. +.. _OPAL_XIVE_SET_IRQ_CONFIG: + OPAL_XIVE_SET_IRQ_CONFIG ^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: c @@ -479,6 +489,8 @@ in the target queue). a new handler for an interrupt that had none. In these case, losing interrupts happening while no handler was attached is considered fine. +.. _OPAL_XIVE_GET_QUEUE_INFO: + OPAL_XIVE_GET_QUEUE_INFO ^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: c @@ -543,6 +555,8 @@ with a virtual processor and a priority. When this is set, the EQ will escalate to the escalation interrupt when failing to notify. +.. _OPAL_XIVE_SET_QUEUE_INFO: + OPAL_XIVE_SET_QUEUE_INFO ^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: c @@ -578,6 +592,8 @@ and priority and adjust the behaviour of the queue via flags. all other flags and arguments are ignored and the queue configuration is wiped. +.. _OPAL_XIVE_DONATE_PAGE: + OPAL_XIVE_DONATE_PAGE ^^^^^^^^^^^^^^^^^^^^^ .. code-block:: c @@ -601,6 +617,8 @@ for each chip in the system and hand it to OPAL before trying again. one page per chip. OPAL will keep returning the above error until enough pages have been provided. +.. _OPAL_XIVE_ALLOCATE_VP_BLOCK: + OPAL_XIVE_ALLOCATE_VP_BLOCK ^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: c @@ -625,6 +643,8 @@ below with the OPAL_XIVE_VP_ENABLED flag set before use. For all priorities, the corresponding queues must also be individually provisioned and enabled with opal_xive_set_queue_info. +.. _OPAL_XIVE_FREE_VP_BLOCK: + OPAL_XIVE_FREE_VP_BLOCK ^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: c @@ -642,6 +662,8 @@ All the queues must also have been disabled. Failure to do any of the above will result in an OPAL_XIVE_FREE_ACTIVE error. +.. _OPAL_XIVE_GET_VP_INFO: + OPAL_XIVE_GET_VP_INFO ^^^^^^^^^^^^^^^^^^^^^ .. code-block:: c @@ -673,6 +695,8 @@ This call returns information about a VP: * chip_id: The chip that VCPU was allocated on +.. _OPAL_XIVE_SET_VP_INFO: + OPAL_XIVE_SET_VP_INFO ^^^^^^^^^^^^^^^^^^^^^ .. code-block:: c @@ -715,6 +739,7 @@ This call configures a VP: .. note:: When disabling a VP, all other VP settings are lost. +.. _OPAL_XIVE_ALLOCATE_IRQ: OPAL_XIVE_ALLOCATE_IRQ ^^^^^^^^^^^^^^^^^^^^^^ @@ -725,6 +750,8 @@ OPAL_XIVE_ALLOCATE_IRQ This call allocates a software IRQ on a given chip. It returns the interrupt number or a negative error code. +.. _OPAL_XIVE_FREE_IRQ: + OPAL_XIVE_FREE_IRQ ^^^^^^^^^^^^^^^^^^ .. code-block:: c @@ -735,6 +762,8 @@ This call frees a software IRQ that was allocated by opal_xive_allocate_irq. Passing any other interrupt number will result in an OPAL_PARAMETER error. +.. _OPAL_XIVE_SYNC: + OPAL_XIVE_SYNC ^^^^^^^^^^^^^^ .. code-block:: c @@ -761,6 +790,7 @@ processor. * id: Depends on the synchronization type, see above +.. _OPAL_XIVE_DUMP: OPAL_XIVE_DUMP ^^^^^^^^^^^^^^ @@ -791,6 +821,7 @@ state information about the XIVE. - XIVE_DUMP_EMU: Dump the state of the XICS emulation for a thread "id" is the PIR value of the thread +.. _OPAL_XIVE_GET_QUEUE_STATE: OPAL_XIVE_GET_QUEUE_STATE ^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -809,6 +840,7 @@ an enabled queue. * out_qindex: index of the queue +.. _OPAL_XIVE_SET_QUEUE_STATE: OPAL_XIVE_SET_QUEUE_STATE ^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -829,6 +861,8 @@ an enabled queue. * qindex: index of the queue +.. _OPAL_XIVE_GET_VP_STATE: + OPAL_XIVE_GET_VP_STATE ^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: c From patchwork Fri May 31 06:12:46 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108097 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZGV04y9z9sDX for ; Fri, 31 May 2019 16:26:26 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZGT63BYzDqdc for ; Fri, 31 May 2019 16:26:25 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0M27CKzDqXw for ; Fri, 31 May 2019 16:14:11 +1000 (AEST) Received: from pps.filterd (m0098416.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64AbG019275 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e32.co.us.ibm.com (e32.co.us.ibm.com [32.97.110.150]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stty1pnf7-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e32.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:06 +0100 Received: from b03cxnp08027.gho.boulder.ibm.com (9.17.130.19) by e32.co.us.ibm.com (192.168.1.132) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:04 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp08027.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3Ve28049766 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id E021B6A04F for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 7B9926A04D for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 35A12503F88; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:46 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0004-0000-0000-0000151674F8 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:05 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0005-0000-0000-00008BDE97A2 Message-Id: <20190531061351.22973-46-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 045/110] doc: Combine and extend OPAL_SENSOR_READ[_U64] docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-sensor-read-88.rst | 71 +++++++++++++++-------- doc/opal-api/opal-sensor-read-u64-162.rst | 16 ----- 2 files changed, 47 insertions(+), 40 deletions(-) delete mode 100644 doc/opal-api/opal-sensor-read-u64-162.rst diff --git a/doc/opal-api/opal-sensor-read-88.rst b/doc/opal-api/opal-sensor-read-88.rst index 6bfc41492bda..793dcfdf6f5d 100644 --- a/doc/opal-api/opal-sensor-read-88.rst +++ b/doc/opal-api/opal-sensor-read-88.rst @@ -1,8 +1,16 @@ +.. _OPAL_SENSOR_READ: + OPAL_SENSOR_READ ================ +.. code-block:: c + + #define OPAL_SENSOR_READ 88 + + int64_t opal_sensor_read(uint32_t sensor_hndl, int token, uint32_t *sensor_data); + The OPAL sensor call reads a sensor data using a unique handler to -identity the targeted sensor. The `sensor_handler` is provided +identity the targeted sensor. The `sensor_handle` is provided via the device tree and is opaque to the OS (although we currently do use an encoding scheme). @@ -14,46 +22,61 @@ the completion of the request. The OPAL API doesn't enforce alimit on the number of sensor calls that can be in flight. +Internally, :ref:`OPAL_SENSOR_READ` is implemented as a wrapper around +:ref:`OPAL_SENSOR_READ_U64`. Any code targeting processor generations prior +to POWER9 will need to use :ref:`OPAL_CHECK_TOKEN` to ensure :ref:`OPAL_SENSOR_READ_U64` +is present and gracefully fall back to :ref:`OPAL_SENSOR_READ` if it is not. Parameters ---------- :: - uint32_t sensor_handler + uint32_t sensor_handle int token uint32_t *sensor_data Return values ------------- -OPAL_SUCCESS +:ref:`OPAL_SUCCESS` Success! - -OPAL_PARAMETER - invalid sensor handler - -OPAL_UNSUPPORTED +:ref:`OPAL_PARAMETER` + invalid sensor handle +:ref:`OPAL_UNSUPPORTED` platform does not support reading sensors. - -Some sensors may have to be read asynchronously (e.g. because OPAL must -communicate with a service processor). One example is sensors provided -by the FSP on IBM FSP systems. - -OPAL_ASYNC_COMPLETION +:ref:`OPAL_ASYNC_COMPLETION` a request was sent and an async completion will be triggered with the @token argument - -OPAL_PARTIAL +:ref:`OPAL_PARTIAL` the request completed but the data returned is invalid - -OPAL_BUSY_EVENT +:ref:`OPAL_BUSY_EVENT` a previous request is still pending - -OPAL_NO_MEM +:ref:`OPAL_NO_MEM` allocation failed - -OPAL_INTERNAL_ERROR +:ref:`OPAL_INTERNAL_ERROR` communication failure with the FSP - -OPAL_HARDWARE +:ref:`OPAL_HARDWARE` FSP is not available + +.. _OPAL_SENSOR_READ_U64: + +OPAL_SENSOR_READ_U64 +==================== + +.. code-block:: c + + #define OPAL_SENSOR_READ_U64 162 + + s64 opal_sensor_read_u64(u32 sensor_hndl, int token, u64 *sensor_data); + +The OPAL sensor call to read sensor data of type u64. Unlike +opal_sensor_read which reads upto u32 this call can be used to +read values of sensors upto 64bits. The calling conventions and +return values are same as :ref:`OPAL_SENSOR_READ`. + +All sensors can be read through the :ref:`OPAL_SENSOR_READ_U64` call that +can be read using the :ref:`OPAL_SENSOR_READ` call. Internally, +:ref:`OPAL_SENSOR_READ` is a wrapper around :ref:`OPAL_SENSOR_READ_U64`. +Any code targeting processor generations prior to POWER9 will need to use +:ref:`OPAL_CHECK_TOKEN` to ensure :ref:`OPAL_SENSOR_READ_U64` +is present and gracefully fall back to :ref:`OPAL_SENSOR_READ` if it is not. diff --git a/doc/opal-api/opal-sensor-read-u64-162.rst b/doc/opal-api/opal-sensor-read-u64-162.rst deleted file mode 100644 index b75bcbc26c62..000000000000 --- a/doc/opal-api/opal-sensor-read-u64-162.rst +++ /dev/null @@ -1,16 +0,0 @@ -OPAL_SENSOR_READ_U64 -==================== - -The OPAL sensor call to read sensor data of type u64. Unlike -opal_sensor_read which reads upto u32 this call can be used to -read values of sensors upto 64bits. The calling conventions and -return values are same as OPAL_SENSOR_READ. -(ref: doc/opal-api/opal-sensor-read-88.rst) - -Parameters ----------- -:: - - u32 sensor_handler - int token - u64 *sensor_data From patchwork Fri May 31 06:12:47 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108096 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZGG5XCBz9sDX for ; Fri, 31 May 2019 16:26:14 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZGG4fq0zDqdc for ; Fri, 31 May 2019 16:26:14 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0L6qWbzDqYt for ; Fri, 31 May 2019 16:14:10 +1000 (AEST) Received: from pps.filterd (m0098394.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64KrV078616 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e12.ny.us.ibm.com (e12.ny.us.ibm.com [129.33.205.202]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stv42d073-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e12.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:06 +0100 Received: from b01cxnp22033.gho.pok.ibm.com (9.57.198.23) by e12.ny.us.ibm.com (146.89.104.199) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:04 +0100 Received: from b01ledav002.gho.pok.ibm.com (b01ledav002.gho.pok.ibm.com [9.57.199.107]) by b01cxnp22033.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E3lt36831440 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id D809A12405A for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 94B35124054 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav002.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 3A0FC503F8A; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:47 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0060-0000-0000-0000034A56E0 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0061-0000-0000-0000498FD373 Message-Id: <20190531061351.22973-47-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=912 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 046/110] doc: Clean up OPAL power shift ratio docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-power-shift-ratio.rst | 60 +++++++++++++------------ 1 file changed, 32 insertions(+), 28 deletions(-) diff --git a/doc/opal-api/opal-power-shift-ratio.rst b/doc/opal-api/opal-power-shift-ratio.rst index b9c7854532dd..4437b55bb730 100644 --- a/doc/opal-api/opal-power-shift-ratio.rst +++ b/doc/opal-api/opal-power-shift-ratio.rst @@ -1,7 +1,19 @@ .. _opal-psr: +====================== +OPAL Power Shift Ratio +====================== + +Sometimes power management firmware needs to throttle power availability +to system components in order to keep within power cap or thermal limits. +It's possible to set a preference as to what trade-offs power management +firmware will make. For example, certain workloads may heavily prefer +throttling CPU over GPUs or vice-versa. + +.. _OPAL_GET_POWER_SHIFT_RATIO: + OPAL_GET_POWER_SHIFT_RATIO -============================== +========================== OPAL call to read the power-shifting-ratio using a handle to identify the type (e.g CPU vs. GPU, CPU vs. MEM) which is exported via device-tree. @@ -21,24 +33,23 @@ u32 \*ratio Returns ------- -OPAL_SUCCESS - Success -OPAL_PARAMETER +:ref:`OPAL_SUCCESS` + Success +:ref:`OPAL_PARAMETER` Invalid ratio pointer - -OPAL_UNSUPPORTED +:ref:`OPAL_UNSUPPORTED` No support for reading psr - -OPAL_HARDWARE +:ref:`OPAL_HARDWARE` Unable to procced due to the current hardware state - -OPAL_ASYNC_COMPLETION +:ref:`OPAL_ASYNC_COMPLETION` Request was sent and an async completion message will be sent with token and status of the request. +.. _OPAL_SET_POWER_SHIFT_RATIO: + OPAL_SET_POWER_SHIFT_RATIO -============================== +========================== OPAL call to set power-shifting-ratio using a handle to identify the type of PSR which is exported in device-tree. This call can be asynchronus where the token parameter is used to wait for the @@ -56,30 +67,23 @@ u32 ratio Returns ------- -OPAL_SUCCESS - Success -OPAL_PARAMETER +:ref:`OPAL_SUCCESS` + Success +:ref:`OPAL_PARAMETER` Invalid ratio requested - -OPAL_UNSUPPORTED +:ref:`OPAL_UNSUPPORTED` No support for changing the ratio - -OPAL_PERMISSION +:ref:`OPAL_PERMISSION` Hardware cannot take the request - -OPAL_ASYNC_COMPLETION +:ref:`OPAL_ASYNC_COMPLETION` Request was sent and an async completion message will be sent with token and status of the request. - -OPAL_HARDWARE +:ref:`OPAL_HARDWARE` Unable to procced due to the current hardware state - -OPAL_BUSY +:ref:`OPAL_BUSY` Previous request in progress - -OPAL_INTERNAL_ERROR +:ref:`OPAL_INTERNAL_ERROR` Error in request response - -OPAL_TIMEOUT +:ref:`OPAL_TIMEOUT` Timeout in request completion From patchwork Fri May 31 06:12:48 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108116 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZMK46vcz9s00 for ; Fri, 31 May 2019 16:30:37 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZMK2pY7zDqdc for ; Fri, 31 May 2019 16:30:37 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N4nskzDqZ2 for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098413.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V68hFm038001 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e14.ny.us.ibm.com (e14.ny.us.ibm.com [129.33.205.204]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxr105pg-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:08 -0400 Received: from localhost by e14.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b01cxnp22036.gho.pok.ibm.com (9.57.198.26) by e14.ny.us.ibm.com (146.89.104.201) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b01ledav002.gho.pok.ibm.com (b01ledav002.gho.pok.ibm.com [9.57.199.107]) by b01cxnp22036.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4hj32833970 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 20959124058 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 99789124053 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav002.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 3F34B503F8C; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:48 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0052-0000-0000-000003C9773A X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0053-0000-0000-0000611BF5E4 Message-Id: <20190531061351.22973-48-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=836 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 047/110] doc: combine OPAL_SENSOR_GROUP_ENABLE and OPAL_SENSOR_GROUP_CLEAR X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/device-tree/ibm,opal/sensor-groups.rst | 2 + doc/opal-api/opal-sensor-group-clear-156.rst | 38 -------- doc/opal-api/opal-sensor-group-enable-163.rst | 41 --------- ...opal-sensor-group-enable-clear-163-156.rst | 88 +++++++++++++++++++ 4 files changed, 90 insertions(+), 79 deletions(-) delete mode 100644 doc/opal-api/opal-sensor-group-clear-156.rst delete mode 100644 doc/opal-api/opal-sensor-group-enable-163.rst create mode 100644 doc/opal-api/opal-sensor-group-enable-clear-163-156.rst diff --git a/doc/device-tree/ibm,opal/sensor-groups.rst b/doc/device-tree/ibm,opal/sensor-groups.rst index 05528d44fc20..037092365907 100644 --- a/doc/device-tree/ibm,opal/sensor-groups.rst +++ b/doc/device-tree/ibm,opal/sensor-groups.rst @@ -1,3 +1,5 @@ +.. _device-tree/ibm,opal/sensor-groups: + ibm,opal/sensor-groups ---------------------- diff --git a/doc/opal-api/opal-sensor-group-clear-156.rst b/doc/opal-api/opal-sensor-group-clear-156.rst deleted file mode 100644 index 1a51c84e7716..000000000000 --- a/doc/opal-api/opal-sensor-group-clear-156.rst +++ /dev/null @@ -1,38 +0,0 @@ -.. _OPAL_SENSOR_GROUP_CLEAR: - -OPAL_SENSOR_GROUP_CLEAR -======================= - -.. code-block:: c - - int opal_sensor_group_clear(u32 group_hndl, int token); - - #define OPAL_SENSOR_GROUP_CLEAR 156 - -OPAL call to clear the sensor groups data using a handle to identify -the type of sensor group which is exported via DT. - -The call can be asynchronus, where the token parameter is used to wait -for the completion. - - -Returns -------- - -:ref:`OPAL_SUCCESS` - Success -:ref:`OPAL_UNSUPPORTED` - No support for clearing the sensor group -:ref:`OPAL_HARDWARE` - Unable to procced due to the current hardware state -:ref:`OPAL_PERMISSION` - Hardware cannot take the request -:ref:`OPAL_ASYNC_COMPLETION` - Request was sent and an async completion message will be sent with - token and status of the request. -:ref:`OPAL_BUSY` - Previous request in progress -:ref:`OPAL_INTERNAL_ERROR` - Error in request response -:ref:`OPAL_TIMEOUT` - Timeout in request completion diff --git a/doc/opal-api/opal-sensor-group-enable-163.rst b/doc/opal-api/opal-sensor-group-enable-163.rst deleted file mode 100644 index 222a20239a10..000000000000 --- a/doc/opal-api/opal-sensor-group-enable-163.rst +++ /dev/null @@ -1,41 +0,0 @@ -.. _OPAL_SENSOR_GROUP_ENABLE: - -OPAL_SENSOR_GROUP_ENABLE -======================== - -.. code-block:: c - - #define OPAL_SENSOR_GROUP_ENABLE 163 - - int opal_sensor_group_enable(u32 group_hndl, int token, bool enable); - -OPAL call to enable/disable the sensor group using a handle to identify -the type of sensor group provided in the device tree. - -For example this call is used to disable/enable copying of sensor -group by OCC to main memory. - -The call can be asynchronus, where the token parameter is used to wait -for the completion. - - -Returns -------- - -:ref:`OPAL_SUCCESS` - Success -:ref:`OPAL_UNSUPPORTED` - No support to enable/disable the sensor group -:ref:`OPAL_HARDWARE` - Unable to procced due to the current hardware state -:ref:`OPAL_PERMISSION` - Hardware cannot take the request -:ref:`OPAL_ASYNC_COMPLETION` - Request was sent and an async completion message will be sent with - token and status of the request. -:ref:`OPAL_BUSY` - Previous request in progress -:ref:`OPAL_INTERNAL_ERROR` - Error in request response -:ref:`OPAL_TIMEOUT` - Timeout in request completion diff --git a/doc/opal-api/opal-sensor-group-enable-clear-163-156.rst b/doc/opal-api/opal-sensor-group-enable-clear-163-156.rst new file mode 100644 index 000000000000..dbf5e3a66e3a --- /dev/null +++ b/doc/opal-api/opal-sensor-group-enable-clear-163-156.rst @@ -0,0 +1,88 @@ +.. _opal-sensor-groups: + +================== +OPAL Sensor Groups +================== + +See :ref:`device-tree/ibm,opal/sensor-groups` for device tree layout. + +.. _OPAL_SENSOR_GROUP_ENABLE: + +OPAL_SENSOR_GROUP_ENABLE +======================== + +.. code-block:: c + + #define OPAL_SENSOR_GROUP_ENABLE 163 + + int opal_sensor_group_enable(u32 group_hndl, int token, bool enable); + +OPAL call to enable/disable the sensor group using a handle to identify +the type of sensor group provided in the device tree. + +For example this call is used to disable/enable copying of sensor +group by OCC to main memory. + +The call can be asynchronus, where the token parameter is used to wait +for the completion. + + +Returns +------- + +:ref:`OPAL_SUCCESS` + Success +:ref:`OPAL_UNSUPPORTED` + No support to enable/disable the sensor group +:ref:`OPAL_HARDWARE` + Unable to procced due to the current hardware state +:ref:`OPAL_PERMISSION` + Hardware cannot take the request +:ref:`OPAL_ASYNC_COMPLETION` + Request was sent and an async completion message will be sent with + token and status of the request. +:ref:`OPAL_BUSY` + Previous request in progress +:ref:`OPAL_INTERNAL_ERROR` + Error in request response +:ref:`OPAL_TIMEOUT` + Timeout in request completion + +.. _OPAL_SENSOR_GROUP_CLEAR: + +OPAL_SENSOR_GROUP_CLEAR +======================= + +.. code-block:: c + + int opal_sensor_group_clear(u32 group_hndl, int token); + + #define OPAL_SENSOR_GROUP_CLEAR 156 + +OPAL call to clear the sensor groups data using a handle to identify +the type of sensor group which is exported via DT. + +The call can be asynchronus, where the token parameter is used to wait +for the completion. + + +Returns +------- + +:ref:`OPAL_SUCCESS` + Success +:ref:`OPAL_UNSUPPORTED` + No support for clearing the sensor group +:ref:`OPAL_HARDWARE` + Unable to procced due to the current hardware state +:ref:`OPAL_PERMISSION` + Hardware cannot take the request +:ref:`OPAL_ASYNC_COMPLETION` + Request was sent and an async completion message will be sent with + token and status of the request. +:ref:`OPAL_BUSY` + Previous request in progress +:ref:`OPAL_INTERNAL_ERROR` + Error in request response +:ref:`OPAL_TIMEOUT` + Timeout in request completion From patchwork Fri May 31 06:12:49 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108100 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZHC46wVz9s00 for ; Fri, 31 May 2019 16:27:03 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZHC2t1KzDqcP for ; Fri, 31 May 2019 16:27:03 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0M676NzDqXX for ; Fri, 31 May 2019 16:14:11 +1000 (AEST) Received: from pps.filterd (m0098409.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V643Gr060081 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e35.co.us.ibm.com (e35.co.us.ibm.com [32.97.110.153]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4v99xu-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e35.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b03cxnp08028.gho.boulder.ibm.com (9.17.130.20) by e35.co.us.ibm.com (192.168.1.135) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b03ledav002.gho.boulder.ibm.com (b03ledav002.gho.boulder.ibm.com [9.17.130.233]) by b03cxnp08028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4c121955040 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b03ledav002.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id F1321136051 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from b03ledav002.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 8DAB413604F for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav002.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 43A52503F8F; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:49 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0012-0000-0000-0000173DDCFA X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0013-0000-0000-00005778F806 Message-Id: <20190531061351.22973-49-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=627 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 048/110] doc: Extend OPAL_LEDS_[GET|SET]_INDICATOR X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" There are some useful comments from the FSP code that help explain how these calls work. Signed-off-by: Stewart Smith --- doc/opal-api/opal-led-get-set-114-115.rst | 74 ++++++++++++++++++++++- 1 file changed, 73 insertions(+), 1 deletion(-) diff --git a/doc/opal-api/opal-led-get-set-114-115.rst b/doc/opal-api/opal-led-get-set-114-115.rst index c0d874ea636d..0de7c4c0020c 100644 --- a/doc/opal-api/opal-led-get-set-114-115.rst +++ b/doc/opal-api/opal-led-get-set-114-115.rst @@ -50,12 +50,84 @@ Note: There are two OPAL calls relating to LED operations. +.. _OPAL_LEDS_GET_INDICATOR: + OPAL_LEDS_GET_INDICATOR ----------------------- + +.. code-block:: c + + #define OPAL_LEDS_GET_INDICATOR 114 + + int64_t opal_leds_get_indicator(char *loc_code, u64 *led_mask, + u64 *led_value, u64 *max_led_type); + Returns LED state for the given location code. +``loc_code`` + Location code of the LEDs. +``led_mask`` + LED types whose status is available (return by OPAL) +``led_value`` + Status of the available LED types (return by OPAL) +``max_led_type`` + Maximum number of supported LED types (Host/OPAL) + +The host will pass the location code of the LED types (loc_code) and +maximum number of LED types it understands (max_led_type). OPAL will +update the 'led_mask' with set bits pointing to LED types whose status +is available and updates the 'led_value' with actual status. OPAL checks +the 'max_led_type' to understand whether the host is newer or older +compared to itself. In the case where the OPAL is newer compared +to host (OPAL's max_led_type > host's max_led_type), it will update +led_mask and led_value according to max_led_type requested by the host. +When the host is newer compared to the OPAL (host's max_led_type > +OPAL's max_led_type), OPAL updates 'max_led_type' to the maximum +number of LED type it understands and updates 'led_mask', 'led_value' +based on that maximum value of LED types. + +Currently this is only implemented on FSP basde machines, see +hw/fsp/fsp-leds.c for more deatails. + +.. _OPAL_LEDS_SET_INDICATOR: + OPAL_LEDS_SET_INDICATOR ----------------------- + +.. code-block:: c + + #define OPAL_LEDS_SET_INDICATOR 115 + + int64_t opal_leds_set_indicator(uint64_t async_token, + char *loc_code, const u64 led_mask, + const u64 led_value, u64 *max_led_type); + Sets LED state for the given location code. -See hw/fsp/fsp-leds.c for more deatails. +``loc_code`` + Location code of the LEDs to be set. +``led_mask`` + LED types whose status will be updated +``led_value`` + Requested status of various LED types. +``max_led_type`` + Maximum number of supported LED types. If OPAL supports fewer LED types + than requested, it will set ``max_led_type`` to the maximum it does support. + +The host will pass the location code of the LED types, mask, value +and maximum number of LED types it understands. OPAL will update +LED status for all the LED types mentioned in the mask with their +value mentioned. OPAL checks the 'max_led_type' to understand +whether the host is newer or older compared to itself. In case where +the OPAL is newer compared to the host (OPAL's max_led_type > + host's max_led_type), it updates LED status based on max_led_type +requested from the host. When the host is newer compared to the OPAL +(host's max_led_type > OPAL's max_led_type), OPAL updates +'max_led_type' to the maximum number of LED type it understands and +then it updates LED status based on that updated maximum value of LED +types. Host needs to check the returned updated value of max_led_type +to figure out which part of it's request got served and which ones got +ignored. + +Currently this is only implemented on FSP basde machines, see +hw/fsp/fsp-leds.c for more deatails. From patchwork Fri May 31 06:12:50 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108084 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZCJ2srmz9sDX for ; Fri, 31 May 2019 16:23:40 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZCJ1sn7zDqWj for ; Fri, 31 May 2019 16:23:40 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0K65ZjzDqYL for ; Fri, 31 May 2019 16:14:09 +1000 (AEST) Received: from pps.filterd (m0098409.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V643du060041 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e32.co.us.ibm.com (e32.co.us.ibm.com [32.97.110.150]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4v99xk-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e32.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:06 +0100 Received: from b03cxnp08028.gho.boulder.ibm.com (9.17.130.20) by e32.co.us.ibm.com (192.168.1.132) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:04 +0100 Received: from b03ledav001.gho.boulder.ibm.com (b03ledav001.gho.boulder.ibm.com [9.17.130.232]) by b03cxnp08028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E39l30474746 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:03 GMT Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id CAC776E050 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 93BA96E04C for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav001.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 48329503F92; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:50 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0004-0000-0000-0000151674F9 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:05 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0005-0000-0000-00008BDE97A1 Message-Id: <20190531061351.22973-50-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 049/110] doc: prettify and flesh out OPAL_FLASH_* call documentation X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-flash-110-111-112.rst | 65 ++++++++++++++----------- 1 file changed, 37 insertions(+), 28 deletions(-) diff --git a/doc/opal-api/opal-flash-110-111-112.rst b/doc/opal-api/opal-flash-110-111-112.rst index e05bd2db504b..cee9bcc7dcea 100644 --- a/doc/opal-api/opal-flash-110-111-112.rst +++ b/doc/opal-api/opal-flash-110-111-112.rst @@ -1,7 +1,9 @@ OPAL Flash calls ================ -There are three OPAL calls for interacting with flash devices: :: +There are three OPAL calls for interacting with flash devices: + +.. code-block:: c #define OPAL_FLASH_READ 110 #define OPAL_FLASH_WRITE 111 @@ -16,64 +18,71 @@ All operations on the flash device must be aligned to the block size of the flash. This applies to both offset and size arguments. This interface is asynchronous; all calls require a 'token' argument. On -success, the calls will return ``OPAL_ASYNC_COMPLETION``, and an +success, the calls will return :ref:`OPAL_ASYNC_COMPLETION`, and an opal_async_completion message will be sent (with the appropriate token argument) when the operation completes. +.. note:: These calls can have higher than normal latency, spending many + **milliseconds** inside OPAL. This is due to the OPAL_FLASH_* calls + typically being backed by flash on the other side of the LPC bus, + which has a maximum transfer rate of 5MB/sec, or to/from flash attached + to the ast2400/ast2500 (the typical setup for OpenPOWER systems) of + only 1.75MB/sec. + All calls share the same return values: -``OPAL_ASYNC_COMPLETION`` +:ref:`OPAL_ASYNC_COMPLETION` operation started, an async completion will be triggered with the ``token`` argument - -``OPAL_PARAMETER`` +:ref:`OPAL_PARAMETER` invalid flash id - -``OPAL_PARAMETER`` +:ref:`OPAL_PARAMETER` invalid size or offset (alignment, or access beyond end of device) - -``OPAL_BUSY`` +:ref:`OPAL_BUSY` flash in use - -``OPAL_HARDWARE`` +:ref:`OPAL_HARDWARE` error accessing flash device +.. _OPAL_FLASH_READ: + OPAL_FLASH_READ --------------- -Parameters: :: +.. code-block:: c + + #define OPAL_FLASH_READ 110 - uint64_t id - uint64_t offset - uint64_t buffer - uint64_t size - uint64_t token + int64_t opal_flash_read(uint64_t id, uint64_t offset, uint64_t buf, + uint64_t size, uint64_t token); Reads from the specified flash id, at the specified offset, into the buffer. Will trigger an async completion with token when completed. +.. _OPAL_FLASH_ERASE: + OPAL_FLASH_ERASE ---------------- -Parameters: :: +.. code-block:: c - uint64_t id - uint64_t offset - uint64_t size - uint64_t token + #define OPAL_FLASH_ERASE 112 + + int64_t opal_flash_erase(uint64_t id, uint64_t offset, uint64_t size, + uint64_t token); Erases the specified flash id, at the specified offset and size. Will trigger an async completion with token when completed. +.. _OPAL_FLASH_WRITE: + OPAL_FLASH_WRITE ---------------- -Parameters: :: +.. code-block:: c + + #define OPAL_FLASH_WRITE 111 - uint64_t id - uint64_t offset - uint64_t buffer - uint64_t size - uint64_t token + int64_t opal_flash_write(uint64_t id, uint64_t offset, uint64_t buf, + uint64_t size, uint64_t token); Writes buffer to the specified flash id, at the specified offset and size. The flash must be erased before being written. Will trigger an async completion with From patchwork Fri May 31 06:12:51 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108108 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZK93JYMz9s00 for ; Fri, 31 May 2019 16:28:45 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZK92NTvzDqcJ for ; Fri, 31 May 2019 16:28:45 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N2Wq2zDqYb for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098414.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V6421H133914 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e34.co.us.ibm.com (e34.co.us.ibm.com [32.97.110.152]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stwdwjr2b-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:08 -0400 Received: from localhost by e34.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b03cxnp08028.gho.boulder.ibm.com (9.17.130.20) by e34.co.us.ibm.com (192.168.1.134) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp08028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4HK32702804 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 0194A6A058 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id BEF356A051 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 4CBE6503F94; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:51 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0016-0000-0000-000009BC52A4 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:05 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0017-0000-0000-0000436E2D0C Message-Id: <20190531061351.22973-51-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 050/110] doc: Add OPAL_I2C_REQUEST documentation X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Fixes: https://github.com/open-power/skiboot/issues/132 Signed-off-by: Stewart Smith --- doc/opal-api/opal-i2c-request-109.rst | 64 +++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 doc/opal-api/opal-i2c-request-109.rst diff --git a/doc/opal-api/opal-i2c-request-109.rst b/doc/opal-api/opal-i2c-request-109.rst new file mode 100644 index 000000000000..edcde4bcb094 --- /dev/null +++ b/doc/opal-api/opal-i2c-request-109.rst @@ -0,0 +1,64 @@ +.. _OPAL_I2C_REQUEST: + +OPAL_I2C_REQUEST +================ + +.. code-block:: c + + #define OPAL_I2C_REQUEST 109 + + /* OPAL I2C request */ + struct opal_i2c_request { + uint8_t type; + #define OPAL_I2C_RAW_READ 0 + #define OPAL_I2C_RAW_WRITE 1 + #define OPAL_I2C_SM_READ 2 + #define OPAL_I2C_SM_WRITE 3 + uint8_t flags; + #define OPAL_I2C_ADDR_10 0x01 /* Not supported yet */ + uint8_t subaddr_sz; /* Max 4 */ + uint8_t reserved; + __be16 addr; /* 7 or 10 bit address */ + __be16 reserved2; + __be32 subaddr; /* Sub-address if any */ + __be32 size; /* Data size */ + __be64 buffer_ra; /* Buffer real address */ + }; + + int opal_i2c_request(uint64_t async_token, uint32_t bus_id, + struct opal_i2c_request *oreq); + +Initiate I2C request using i2c master that OPAL controls. + +Return Codes +------------ + +Most return codes will come through as part of async completion. + +:ref:`OPAL_PARAMETER` + Invalid request pointer, or bus ID. +:ref:`OPAL_UNSUPPORTED` + Unsupported operation. e.g. 10 bit addresses not yet supported. +:ref:`OPAL_NO_MEM` + Not enough free memory in OPAL to initiate request. +:ref:`OPAL_ASYNC_COMPLETION` + Operation will complete asynchronously. +:ref:`OPAL_I2C_TIMEOUT` + I2C operation initiated successfully, but timed out. +:ref:`OPAL_I2C_INVALID_CMD` + Invalid i2c Command. +:ref:`OPAL_I2C_LBUS_PARITY` + I2C LBUS Parity error +:ref:`OPAL_I2C_BKEND_OVERRUN` + I2C Backend overrun. +:ref:`OPAL_I2C_BKEND_ACCESS` + I2C Backend Access error. +:ref:`OPAL_I2C_ARBT_LOST` + I2C Bus Arbitration lost. +:ref:`OPAL_I2C_NACK_RCVD` + I2C NACK received. +:ref:`OPAL_I2C_STOP_ERR` + I2C STOP error. +:ref:`OPAL_SUCCESS` + I2C operation completed successfully. Typically only as part of + async completion. From patchwork Fri May 31 06:12:52 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108106 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZJj2Ynfz9s00 for ; Fri, 31 May 2019 16:28:21 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZJj0pVrzDqbC for ; Fri, 31 May 2019 16:28:21 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N2MnSzDqYX for ; Fri, 31 May 2019 16:14:11 +1000 (AEST) Received: from pps.filterd (m0098394.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64KEQ078624 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e12.ny.us.ibm.com (e12.ny.us.ibm.com [129.33.205.202]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stv42d079-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:08 -0400 Received: from localhost by e12.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:06 +0100 Received: from b01cxnp22036.gho.pok.ibm.com (9.57.198.26) by e12.ny.us.ibm.com (146.89.104.199) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b01ledav001.gho.pok.ibm.com (b01ledav001.gho.pok.ibm.com [9.57.199.106]) by b01cxnp22036.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E43a36503900 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 213F528060 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id DCC6E2805A for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav001.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 5113E503F96; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:52 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0060-0000-0000-0000034A56E1 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0061-0000-0000-0000498FD375 Message-Id: <20190531061351.22973-52-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 051/110] doc: Flesh out OPAL_(READ|WRITE)_TPO and OPAL_GET_DPO_STATUS docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Fixes: https://github.com/open-power/skiboot/issues/130 Signed-off-by: Stewart Smith --- doc/opal-api/opal-messages.rst | 1 + doc/opal-api/opal-read-write-tpo-103-104.rst | 15 ---- .../opal-read-write-tpo-dpo-103-104-105.rst | 82 +++++++++++++++++++ 3 files changed, 83 insertions(+), 15 deletions(-) delete mode 100644 doc/opal-api/opal-read-write-tpo-103-104.rst create mode 100644 doc/opal-api/opal-read-write-tpo-dpo-103-104-105.rst diff --git a/doc/opal-api/opal-messages.rst b/doc/opal-api/opal-messages.rst index e7de77d96850..54ef340b7173 100644 --- a/doc/opal-api/opal-messages.rst +++ b/doc/opal-api/opal-messages.rst @@ -125,6 +125,7 @@ Notes: } u; }; +.. _OPAL_MSG_DPO: OPAL_MSG_DPO ------------ diff --git a/doc/opal-api/opal-read-write-tpo-103-104.rst b/doc/opal-api/opal-read-write-tpo-103-104.rst deleted file mode 100644 index b46500650376..000000000000 --- a/doc/opal-api/opal-read-write-tpo-103-104.rst +++ /dev/null @@ -1,15 +0,0 @@ -OPAL_READ_TPO and OPAL_WRITE_TPO -================================ - -TPO is a Timed Power On facility. - -It is an OPTIONAL part of the OPAL spec. - -If a platform supports Timed Power On (TPO), the RTC node in the device tree (itself under the "ibm,opal" node will have the has-tpo property: :: - - rtc { - compatible = "ibm,opal-rtc"; - has-tpo; - }; - -If the "has-tpo" proprety is *NOT* present then OPAL does *NOT* support TPO. diff --git a/doc/opal-api/opal-read-write-tpo-dpo-103-104-105.rst b/doc/opal-api/opal-read-write-tpo-dpo-103-104-105.rst new file mode 100644 index 000000000000..52bb67e3870a --- /dev/null +++ b/doc/opal-api/opal-read-write-tpo-dpo-103-104-105.rst @@ -0,0 +1,82 @@ + +========================================= +OPAL Timed Power On and Delayed Power Off +========================================= + +.. code-block:: c + + #define OPAL_WRITE_TPO 103 + #define OPAL_READ_TPO 104 + #define OPAL_GET_DPO_STATUS 105 + +TPO is a Timed Power On facility, and DPO is Delayed Power Off. + +It is an OPTIONAL part of the OPAL spec. + +If a platform supports Timed Power On (TPO), the RTC node in the device tree +(itself under the "ibm,opal" node will have the has-tpo property: + +.. code-block:: dts + + rtc { + compatible = "ibm,opal-rtc"; + has-tpo; + }; + +If the "has-tpo" proprety is *NOT* present then OPAL does *NOT* support TPO. + +.. _OPAL_READ_TPO: + +OPAL_READ_TPO +============= + +.. code-block:: c + + #define OPAL_READ_TPO 104 + + static int64_t opal_read_tpo(uint64_t async_token, uint32_t *y_m_d, uint32_t *hr_min); + + +.. _OPAL_WRITE_TPO: + +OPAL_WRITE_TPO +============== + +.. code-block:: c + + #define OPAL_WRITE_TPO 103 + + int64_t fsp_opal_tpo_write(uint64_t async_token, uint32_t y_m_d, uint32_t hr_min); + + +.. _OPAL_GET_DPO_STATUS: + +OPAL_GET_DPO_STATUS +=================== + +.. code-block:: c + + #define OPAL_GET_DPO_STATUS 105 + + static int64_t opal_get_dpo_status(int64_t *dpo_timeout); + +A :ref:`OPAL_MSG_DPO` message may be sent to indicate that there will shortly +be a forced system shutdown. In this case, an OS can call +:ref:`OPAL_GET_DPO_STATUS` to find out how many seconds it has before power +is cut to the system. + +This call could be present on systems where the service processor is integrated +with a UPS or similar. + +Returns zero if Delayed Power Off is not active, positive value indicating +number of seconds remaining for a forced system shutdown. This will enable +the host to schedule for shutdown voluntarily before timeout occurs. + +Returns +------- + +:ref:`OPAL_SUCCESS` + ``dpo_timeout`` is set to the number of seconds remaining before power is + cut. +:ref:`OPAL_WRONG_STATE` + A Delayed Power Off is not pending, ``dpo_timeout`` is set to zero. From patchwork Fri May 31 06:12:53 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108177 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZbd6W88z9s00 for ; Fri, 31 May 2019 16:41:17 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZbd5NhfzDrCG for ; Fri, 31 May 2019 16:41:17 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ1p400gzDqYb for ; Fri, 31 May 2019 16:15:26 +1000 (AEST) Received: from pps.filterd (m0098410.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V648fn140958 for ; Fri, 31 May 2019 02:15:24 -0400 Received: from e16.ny.us.ibm.com (e16.ny.us.ibm.com [129.33.205.206]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4vsbdx-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:15:23 -0400 Received: from localhost by e16.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:15:22 +0100 Received: from b01cxnp22036.gho.pok.ibm.com (9.57.198.26) by e16.ny.us.ibm.com (146.89.104.203) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:15:20 +0100 Received: from b01ledav001.gho.pok.ibm.com (b01ledav001.gho.pok.ibm.com [9.57.199.106]) by b01cxnp22036.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4di7471542 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 2972328059 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id DBC6928058 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav001.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 56996503F99; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:53 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0072-0000-0000-00000435AFE7 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992125; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:15:21 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0073-0000-0000-00004C6D3DA1 Message-Id: <20190531061351.22973-53-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=771 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 052/110] doc: Flesh out OPAL_(UN)REGISTER_DUMP_REGION docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-dump-region-101-102.rst | 100 ++++++++++++++++++ .../opal-register-dump-region-101.rst | 45 -------- .../opal-unregister-dump-region-102.rst | 19 ---- 3 files changed, 100 insertions(+), 64 deletions(-) create mode 100644 doc/opal-api/opal-dump-region-101-102.rst delete mode 100644 doc/opal-api/opal-register-dump-region-101.rst delete mode 100644 doc/opal-api/opal-unregister-dump-region-102.rst diff --git a/doc/opal-api/opal-dump-region-101-102.rst b/doc/opal-api/opal-dump-region-101-102.rst new file mode 100644 index 000000000000..dca63f6e5c9a --- /dev/null +++ b/doc/opal-api/opal-dump-region-101-102.rst @@ -0,0 +1,100 @@ +================= +OPAL Dump Regions +================= + +.. code-block:: c + + #define OPAL_REGISTER_DUMP_REGION 101 + #define OPAL_UNREGISTER_DUMP_REGION 102 + + int64_t opal_register_dump_region(uint32_t id, uint64_t addr, uint64_t size); + int64_t opal_unregister_dump_region(uint32_t id); + +In the event of crashes, some service processors and firmware support gathering +a limited amount of memory from a limited number of memory regions to save into +a debug dump that can be useful for firmware and operating system developers +in diagnosing problems. Typically, firmware and kernel log buffers are useful to +save in a dump. + +.. _OPAL_REGISTER_DUMP_REGION: + +OPAL_REGISTER_DUMP_REGION +========================= + +.. code-block:: c + + #define OPAL_REGISTER_DUMP_REGION 101 + + int64_t opal_register_dump_region(uint32_t id, uint64_t addr, uint64_t size); + +This call is used to register regions of memory for a service processor to capture +when the host crashes. + +e.g. if an assert is hit in OPAL, a service processor will copy the region of +memory into some kind of crash dump for further analysis. + +This is an OPTIONAL feature that may be unsupported, the host OS should use an +:ref:`OPAL_CHECK_TOKEN` call to find out if :ref:`OPAL_REGISTER_DUMP_REGION` is supported. + +:ref:`OPAL_REGISTER_DUMP_REGION` accepts 3 parameters: + +- region ID +- address +- length + +There is a range of region IDs that can be used by the host OS. A host OS should +start from OPAL_DUMP_REGION_HOST_END and work down if it wants to add a not well +defined region to dump. Currently the only well defined region is for the host +OS log buffer (e.g. dmesg on linux). :: + + /* + * Dump region ID range usable by the OS + */ + #define OPAL_DUMP_REGION_HOST_START 0x80 + #define OPAL_DUMP_REGION_LOG_BUF 0x80 + #define OPAL_DUMP_REGION_HOST_END 0xFF + +:ref:`OPAL_REGISTER_DUMP_REGION` will return :ref:`OPAL_UNSUPPORTED` if the call is present but +the system doesn't support registering regions to be dumped. + +In the event of being passed an invalid region ID, :ref:`OPAL_REGISTER_DUMP_REGION` will +return :ref:`OPAL_PARAMETER`. + +Systems likely have a limit as to how many regions they can support being dumped. If +this limit is reached, :ref:`OPAL_REGISTER_DUMP_REGION` will return :ref:`OPAL_INTERNAL_ERROR`. + +BUGS +---- +Some skiboot versions incorrectly returned :ref:`OPAL_SUCCESS` in the case of +:ref:`OPAL_REGISTER_DUMP_REGION` being supported on a platform (so the call was present) +but the call being unsupported for some reason (e.g. on an IBM POWER7 machine). + +See also: :ref:`OPAL_UNREGISTER_DUMP_REGION` + +.. _OPAL_UNREGISTER_DUMP_REGION: + +OPAL_UNREGISTER_DUMP_REGION +=========================== + +.. code-block:: c + + #define OPAL_UNREGISTER_DUMP_REGION 102 + + int64_t opal_unregister_dump_region(uint32_t id); + +While :ref:`OPAL_REGISTER_DUMP_REGION` registers a region, :ref:`OPAL_UNREGISTER_DUMP_REGION` +will unregister a region by region ID. + +:ref:`OPAL_UNREGISTER_DUMP_REGION` takes one argument: the region ID. + +A host OS should check :ref:`OPAL_UNREGISTER_DUMP_REGION` is supported through a call to +:ref:`OPAL_CHECK_TOKEN`. + +If :ref:`OPAL_UNREGISTER_DUMP_REGION` is called on a system where the call is present but +unsupported, it will return :ref:`OPAL_UNSUPPORTED`. + +BUGS +---- +Some skiboot versions incorrectly returned :ref:`OPAL_SUCCESS` in the case of +:ref:`OPAL_UNREGISTER_DUMP_REGION` being supported on a platform (so the call was present) +but the call being unsupported for some reason (e.g. on an IBM POWER7 machine). diff --git a/doc/opal-api/opal-register-dump-region-101.rst b/doc/opal-api/opal-register-dump-region-101.rst deleted file mode 100644 index 15300820d1e3..000000000000 --- a/doc/opal-api/opal-register-dump-region-101.rst +++ /dev/null @@ -1,45 +0,0 @@ -OPAL_REGISTER_DUMP_REGION -========================= - -This call is used to register regions of memory for a service processor to capture -when the host crashes. - -e.g. if an assert is hit in OPAL, a service processor will copy - -This is an OPTIONAL feature that may be unsupported, the host OS should use an -OPAL_CHECK_TOKEN call to find out if OPAL_REGISTER_DUMP_REGION is supported. - -OPAL_REGISTER_DUMP_REGION accepts 3 parameters: - -- region ID -- address -- length - -There is a range of region IDs that can be used by the host OS. A host OS should -start from OPAL_DUMP_REGION_HOST_END and work down if it wants to add a not well -defined region to dump. Currently the only well defined region is for the host -OS log buffer (e.g. dmesg on linux). :: - - /* - * Dump region ID range usable by the OS - */ - #define OPAL_DUMP_REGION_HOST_START 0x80 - #define OPAL_DUMP_REGION_LOG_BUF 0x80 - #define OPAL_DUMP_REGION_HOST_END 0xFF - -OPAL_REGISTER_DUMP_REGION will return OPAL_UNSUPPORTED if the call is present but -the system doesn't support registering regions to be dumped. - -In the event of being passed an invalid region ID, OPAL_REGISTER_DUMP_REGION will -return OPAL_PARAMETER. - -Systems likely have a limit as to how many regions they can support being dumped. If -this limit is reached, OPAL_REGISTER_DUMP_REGION will return OPAL_INTERNAL_ERROR. - -BUGS ----- -Some skiboot versions incorrectly returned OPAL_SUCCESS in the case of -OPAL_REGISTER_DUMP_REGION being supported on a platform (so the call was present) -but the call being unsupported for some reason (e.g. on an IBM POWER7 machine). - -See also: OPAL_UNREGISTER_DUMP_REGION diff --git a/doc/opal-api/opal-unregister-dump-region-102.rst b/doc/opal-api/opal-unregister-dump-region-102.rst deleted file mode 100644 index d382c82631b6..000000000000 --- a/doc/opal-api/opal-unregister-dump-region-102.rst +++ /dev/null @@ -1,19 +0,0 @@ -OPAL_UNREGISTER_DUMP_REGION -=========================== - -While OPAL_REGISTER_DUMP_REGION registers a region, OPAL_UNREGISTER_DUMP_REGION -will unregister a region by region ID. - -OPAL_UNREGISTER_DUMP_REGION takes one argument: the region ID. - -A host OS should check OPAL_UNREGISTER_DUMP_REGION is supported through a call to -OPAL_CHECK_TOKEN. - -If OPAL_UNREGISTER_DUMP_REGION is called on a system where the call is present but -unsupported, it will return OPAL_UNSUPPORTED. - -BUGS ----- -Some skiboot versions incorrectly returned OPAL_SUCCESS in the case of -OPAL_UNREGISTER_DUMP_REGION being supported on a platform (so the call was present) -but the call being unsupported for some reason (e.g. on an IBM POWER7 machine). From patchwork Fri May 31 06:12:54 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108113 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZLc0TnYz9s00 for ; Fri, 31 May 2019 16:30:00 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZLb5KcMzDqcT for ; Fri, 31 May 2019 16:29:59 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N3vxNzDqYh for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098404.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64HbG042557 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e13.ny.us.ibm.com (e13.ny.us.ibm.com [129.33.205.203]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4vhd6w-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:08 -0400 Received: from localhost by e13.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b01cxnp23032.gho.pok.ibm.com (9.57.198.27) by e13.ny.us.ibm.com (146.89.104.200) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp23032.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4a839387470 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 3233EB2065 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id E34CAB205F for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 5AC26503F9C; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:54 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0064-0000-0000-000003E76F3C X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:05 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0065-0000-0000-00003DAD78E5 Message-Id: <20190531061351.22973-54-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=699 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 053/110] doc: prettify and flesh out OPAL_XSCOM_READ and OPAL_XSCOM_WRITE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-xscom-read-write-65-66.rst | 91 +++++++++++++++++--- 1 file changed, 78 insertions(+), 13 deletions(-) diff --git a/doc/opal-api/opal-xscom-read-write-65-66.rst b/doc/opal-api/opal-xscom-read-write-65-66.rst index d24651dc05a3..f8006e643ebc 100644 --- a/doc/opal-api/opal-xscom-read-write-65-66.rst +++ b/doc/opal-api/opal-xscom-read-write-65-66.rst @@ -1,23 +1,88 @@ -OPAL_XSCOM_READ and OPAL_XSCOM_WRITE -==================================== +.. _OPAL_XSCOM_READ: -These low level calls will read/write XSCOM values directly. +OPAL_XSCOM_READ +=============== + +.. code-block:: c + + #define OPAL_XSCOM_READ 65 + + int xscom_read(uint32_t partid, uint64_t pcb_addr, uint64_t *val); + +This low level call will read XSCOM values directly. They should only be used by low level manufacturing/debug tools. "Normal" host OS kernel code should not know about XSCOM. -each takes three parameters: :: - - int xscom_read(uint32_t partid, uint64_t pcb_addr, uint64_t *val) - int xscom_write(uint32_t partid, uint64_t pcb_addr, uint64_t val) +This is also needed by HBRT/`opal-prd`. Returns ------- -OPAL_SUCCESS - Success! -OPAL_HARDWARE - if operation failed +:ref:`OPAL_SUCCESS` + Success! +:ref:`OPAL_HARDWARE` + if operation failed +:ref:`OPAL_WRONG_STATE` + if CPU is asleep +:ref:`OPAL_XSCOM_BUSY` + Alias for :ref:`OPAL_BUSY`. +:ref:`OPAL_XSCOM_CHIPLET_OFF` + Alias for :ref:`OPAL_WRONG_STATE` +:ref:`OPAL_XSCOM_PARTIAL_GOOD` + XSCOM Partial Good +:ref:`OPAL_XSCOM_ADDR_ERROR` + XSCOM Address Error +:ref:`OPAL_XSCOM_CLOCK_ERROR` + XSCOM Clock Error +:ref:`OPAL_XSCOM_PARITY_ERROR` + XSCOM Parity Error +:ref:`OPAL_XSCOM_TIMEOUT` + XSCOM Timeout +:ref:`OPAL_XSCOM_CTR_OFFLINED` + XSCOM Controller Offlined due to too many errors. + +.. _OPAL_XSCOM_WRITE: + +OPAL_XSCOM_WRITE +================ + +.. code-block:: c + + #define OPAL_XSCOM_WRITE 66 + + int xscom_write(uint32_t partid, uint64_t pcb_addr, uint64_t val); + + +This low level call will write an XSCOM value directly. + +They should only be used by low level manufacturing/debug tools. +"Normal" host OS kernel code should not know about XSCOM. + +This is also needed by HBRT/`opal-prd`. + +Returns +------- -OPAL_WRONG_STATE - if CPU is asleep +:ref:`OPAL_SUCCESS` + Success! +:ref:`OPAL_HARDWARE` + if operation failed +:ref:`OPAL_WRONG_STATE` + if CPU is asleep +:ref:`OPAL_XSCOM_BUSY` + Alias for :ref:`OPAL_BUSY`. +:ref:`OPAL_XSCOM_CHIPLET_OFF` + Alias for :ref:`OPAL_WRONG_STATE` +:ref:`OPAL_XSCOM_PARTIAL_GOOD` + XSCOM Partial Good +:ref:`OPAL_XSCOM_ADDR_ERROR` + XSCOM Address Error +:ref:`OPAL_XSCOM_CLOCK_ERROR` + XSCOM Clock Error +:ref:`OPAL_XSCOM_PARITY_ERROR` + XSCOM Parity Error +:ref:`OPAL_XSCOM_TIMEOUT` + XSCOM Timeout +:ref:`OPAL_XSCOM_CTR_OFFLINED` + XSCOM Controller Offlined due to too many errors. From patchwork Fri May 31 06:12:55 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108130 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZQM2XNxz9s00 for ; Fri, 31 May 2019 16:33:15 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZQM0lRmzDqhb for ; Fri, 31 May 2019 16:33:15 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P0JhJzDqZN for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098394.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64MAr078773 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e17.ny.us.ibm.com (e17.ny.us.ibm.com [129.33.205.207]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stv42d082-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e17.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b01cxnp23032.gho.pok.ibm.com (9.57.198.27) by e17.ny.us.ibm.com (146.89.104.204) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp23032.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4lG39387472 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 6B0E0B205F for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id E530BB2064 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 5FDDE503F9F; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:55 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0040-0000-0000-000004F6E3D2 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0041-0000-0000-00000902FEA1 Message-Id: <20190531061351.22973-55-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=908 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 054/110] doc: flesh out and prettify OPAL_LPC_(READ|WRITE) X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-lpc-read-write-67-68.rst | 92 +++++++++++++++------- 1 file changed, 62 insertions(+), 30 deletions(-) diff --git a/doc/opal-api/opal-lpc-read-write-67-68.rst b/doc/opal-api/opal-lpc-read-write-67-68.rst index 784147459e08..52d377892330 100644 --- a/doc/opal-api/opal-lpc-read-write-67-68.rst +++ b/doc/opal-api/opal-lpc-read-write-67-68.rst @@ -1,11 +1,30 @@ +.. _OPAL_LPC_READ: + OPAL_LPC_READ ============= -:: - This function related to Low Pin Count (LPC) bus. This function reads the - data from IDSEL register for ``chip_id``, which has LPC information. - From ``addr`` for ``addr_type`` with read size ``sz`` bytes in to a - variable named ``data``. +.. code-block:: c + + #define OPAL_LPC_READ 67 + + /* + * Address cycle types for LPC accesses. These also correspond + * to the content of the first cell of the "reg" property for + * device nodes on the LPC bus + */ + enum OpalLPCAddressType { + OPAL_LPC_MEM = 0, + OPAL_LPC_IO = 1, + OPAL_LPC_FW = 2, + }; + + int64_t opal_lpc_read(uint32_t chip_id, enum OpalLPCAddressType addr_type, + uint32_t addr, uint32_t *data, uint32_t sz); + +This function related to Low Pin Count (LPC) bus. This function reads the +data from IDSEL register for ``chip_id``, which has LPC information. +From ``addr`` for ``addr_type`` with read size ``sz`` bytes in to a +variable named ``data``. Parameters ---------- @@ -13,40 +32,56 @@ Parameters ``chip_id`` The ``chip_id`` parameter contains value of the chip number identified at boot time. - ``addr_type`` The ``addr_type`` is one of the LPC supported address types. - Supported address types are - - LPC memory, - LPC IO and - LPC firmware. + Supported address types are: + + - LPC memory, + - LPC IO and + - LPC firmware. ``addr`` The ``addr`` from which the data has to be read. - ``data`` The ``data`` will be used to store the read data. - ``sz`` How many ``sz`` bytes to be read in to ``data``. Return Codes ------------ -``OPAL_PARAMETER`` +:ref:`OPAL_PARAMETER` Indicates either ``chip_id`` not found or ``chip_id`` doesn’t contain LPC information. - -``OPAL_SUCCESS`` +:ref:`OPAL_SUCCESS` Indicates Success! +.. _OPAL_LPC_WRITE: + OPAL_LPC_WRITE ============== -:: - This function related to Low Pin Count (LPC) bus. This function writes the - ``data`` in to ECCB register for ``chip_id``, which has LPC information. - From ``addr`` for ``addr_type`` with write size ``sz`` bytes. +.. code-block:: c + + #define OPAL_LPC_WRITE 68 + + /* + * Address cycle types for LPC accesses. These also correspond + * to the content of the first cell of the "reg" property for + * device nodes on the LPC bus + */ + enum OpalLPCAddressType { + OPAL_LPC_MEM = 0, + OPAL_LPC_IO = 1, + OPAL_LPC_FW = 2, + }; + + int64_t opal_lpc_write(uint32_t chip_id, enum OpalLPCAddressType addr_type, + uint32_t addr, uint32_t data, uint32_t sz); + +This function related to Low Pin Count (LPC) bus. This function writes the +``data`` in to ECCB register for ``chip_id``, which has LPC information. +From ``addr`` for ``addr_type`` with write size ``sz`` bytes. Parameters ---------- @@ -54,29 +89,26 @@ Parameters ``chip_id`` The ``chip_id`` parameter contains value of the chip number identified at boot time. - ``addr_type`` The ``addr_type`` is one of the address types LPC supported. - Supported address types are - - LPC memory, - LPC IO and - LPC firmware. + Supported address types are: + + - LPC memory, + - LPC IO and + - LPC firmware. ``addr`` The ``addr`` to where the ``data`` need to be written. - ``data`` The ``data`` for writing. - ``sz`` How many ``sz`` bytes to write. Return Codes ------------ -``OPAL_PARAMETER`` +:ref:`OPAL_PARAMETER` Indicates either ``chip_id`` not found or ``chip_id`` doesn’t contain LPC information. - -``OPAL_SUCCESS`` - Indicates Success! +:ref:`OPAL_SUCCESS` + Indicates Success! From patchwork Fri May 31 06:12:56 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108142 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZSp3gHpz9s00 for ; Fri, 31 May 2019 16:35:22 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZSp2my0zDqkk for ; Fri, 31 May 2019 16:35:22 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P1cLlzDqZQ for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098421.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V676fA066802 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e31.co.us.ibm.com (e31.co.us.ibm.com [32.97.110.149]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stxqh877g-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e31.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b03cxnp08027.gho.boulder.ibm.com (9.17.130.19) by e31.co.us.ibm.com (192.168.1.131) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp08027.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4ju18416056 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 440ADBE04F for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id D5074BE05A for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 64C70507BC6; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:56 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-8235-0000-0000-00000EA0F3A9 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-8236-0000-0000-000045C9C0EE Message-Id: <20190531061351.22973-56-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 055/110] doc: misc formatting fixes X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/process/stable-skiboot-rules.rst | 1 + doc/release-notes/skiboot-5.9-rc5.rst | 3 +- doc/release-notes/skiboot-6.0.18.rst | 1 + doc/release-notes/skiboot-6.0.20.rst | 97 +++++++-------- doc/release-notes/skiboot-6.0.rst | 1 + doc/release-notes/skiboot-6.2.2.rst | 7 +- doc/release-notes/skiboot-6.2.4.rst | 163 +++++++++++++------------- 7 files changed, 141 insertions(+), 132 deletions(-) diff --git a/doc/process/stable-skiboot-rules.rst b/doc/process/stable-skiboot-rules.rst index 570bb70ed438..38bae8f4e541 100644 --- a/doc/process/stable-skiboot-rules.rst +++ b/doc/process/stable-skiboot-rules.rst @@ -32,6 +32,7 @@ What patches are accepted? HOWTO submit to stable ---------------------- Two ways: + 1. Send patch to the skiboot-stable@lists.ozlabs.org list with "[PATCH ]" in subject diff --git a/doc/release-notes/skiboot-5.9-rc5.rst b/doc/release-notes/skiboot-5.9-rc5.rst index 04c37f482407..a2beb615a4a3 100644 --- a/doc/release-notes/skiboot-5.9-rc5.rst +++ b/doc/release-notes/skiboot-5.9-rc5.rst @@ -68,8 +68,7 @@ Over :ref:`skiboot-5.9-rc3`, we have the following changes: at error level indicating a problem. - phb4: Fix GEN3 for DD2.00 - In this fix: - 62ac7631ae phb4: Fix PCIe GEN4 on DD2.1 and above + In this fix: ``62ac7631ae`` "phb4: Fix PCIe GEN4 on DD2.1 and above", We fixed DD2.1 GEN4 but broke DD2.00 as GEN3. This fixes DD2.00 back to GEN3. This time for sure! diff --git a/doc/release-notes/skiboot-6.0.18.rst b/doc/release-notes/skiboot-6.0.18.rst index 5465e2e276ed..8011d46a1e70 100644 --- a/doc/release-notes/skiboot-6.0.18.rst +++ b/doc/release-notes/skiboot-6.0.18.rst @@ -110,6 +110,7 @@ BMC communication bt_add_ipmi_msg_head() adds message to top of the list. If bt message list is not empty then: + - if bt_idle() is true then we will endup sending message to BMC before getting response from BMC for inflight message. Looks like on some BMC implementation this results in message timeout. diff --git a/doc/release-notes/skiboot-6.0.20.rst b/doc/release-notes/skiboot-6.0.20.rst index 7a154336e60f..6542dece1ca9 100644 --- a/doc/release-notes/skiboot-6.0.20.rst +++ b/doc/release-notes/skiboot-6.0.20.rst @@ -18,7 +18,7 @@ Bug fixes included in this release are: for flash even if the BMC is not current ready to service flash requests. On the assumption that it will become ready, retry for several minutes to cover a BMC reboot cycle and *eventually* rather than - *immediately* crash out with: + *immediately* crash out with: :: [ 269.549748] reboot: Restarting system [ 390.297462587,5] OPAL: Reboot request... @@ -99,19 +99,19 @@ Bug fixes included in this release are: shows no thread error reported in TFMR register. Without this patch the console event show TFMR with no thread error: - (DEC parity error TFMR[59] injection) + (DEC parity error TFMR[59] injection) :: - [ 53.737572] Severe Hypervisor Maintenance interrupt [Recovered] - [ 53.737596] Error detail: Timer facility experienced an error - [ 53.737611] HMER: 0840000000000000 - [ 53.737621] TFMR: 3212000870e04000 + [ 53.737572] Severe Hypervisor Maintenance interrupt [Recovered] + [ 53.737596] Error detail: Timer facility experienced an error + [ 53.737611] HMER: 0840000000000000 + [ 53.737621] TFMR: 3212000870e04000 - After this patch it shows old TFMR value on host console: + After this patch it shows old TFMR value on host console: :: - [ 2302.267271] Severe Hypervisor Maintenance interrupt [Recovered] - [ 2302.267305] Error detail: Timer facility experienced an error - [ 2302.267320] HMER: 0840000000000000 - [ 2302.267330] TFMR: 3212000870e14010 + [ 2302.267271] Severe Hypervisor Maintenance interrupt [Recovered] + [ 2302.267305] Error detail: Timer facility experienced an error + [ 2302.267320] HMER: 0840000000000000 + [ 2302.267330] TFMR: 3212000870e14010 - libflash/ipmi-hiomap: Fix blocks count issue @@ -119,11 +119,12 @@ Bug fixes included in this release are: If data size is not block aligned then we endup sending block count less than actual data. BMC will write partial data to flash memory. - Sample log : - [ 594.388458416,7] HIOMAP: Marked flash dirty at 0x42010 for 8 - [ 594.398756487,7] HIOMAP: Flushed writes - [ 594.409596439,7] HIOMAP: Marked flash dirty at 0x42018 for 3970 - [ 594.419897507,7] HIOMAP: Flushed writes + Sample log :: + + [ 594.388458416,7] HIOMAP: Marked flash dirty at 0x42010 for 8 + [ 594.398756487,7] HIOMAP: Flushed writes + [ 594.409596439,7] HIOMAP: Marked flash dirty at 0x42018 for 3970 + [ 594.419897507,7] HIOMAP: Flushed writes In this case HIOMAP sent data with block count=0 and hence BMC didn't flush data to flash. @@ -136,37 +137,37 @@ Bug fixes included in this release are: pnv_platform_error_reboot() path due to unrecoverable hmi event, the panic cpu gets stuck in OPAL inside ipmi_queue_msg_sync(). At this time, rest all other cpus are in smp_handle_nmi_ipi() waiting for panic cpu to proceed. - But with panic cpu stuck inside OPAL, linux never recovers/reboot. - - p0 c1 t0 - NIA : 0x000000003001dd3c <.time_wait+0x64> - CFAR : 0x000000003001dce4 <.time_wait+0xc> - MSR : 0x9000000002803002 - LR : 0x000000003002ecf8 <.ipmi_queue_msg_sync+0xec> - - STACK: SP NIA - 0x0000000031c236e0 0x0000000031c23760 (big-endian) - 0x0000000031c23760 0x000000003002ecf8 <.ipmi_queue_msg_sync+0xec> - 0x0000000031c237f0 0x00000000300aa5f8 <.hiomap_queue_msg_sync+0x7c> - 0x0000000031c23880 0x00000000300aaadc <.hiomap_window_move+0x150> - 0x0000000031c23950 0x00000000300ab1d8 <.ipmi_hiomap_write+0xcc> - 0x0000000031c23a90 0x00000000300a7b18 <.blocklevel_raw_write+0xbc> - 0x0000000031c23b30 0x00000000300a7c34 <.blocklevel_write+0xfc> - 0x0000000031c23bf0 0x0000000030030be0 <.flash_nvram_write+0xd4> - 0x0000000031c23c90 0x000000003002c128 <.opal_write_nvram+0xd0> - 0x0000000031c23d20 0x00000000300051e4 - 0xc000001fea6e7870 0xc0000000000a9060 - 0xc000001fea6e78c0 0xc000000000030b84 - 0xc000001fea6e7960 0xc0000000000310b0 - 0xc000001fea6e7990 0xc0000000004792d4 - 0xc000001fea6e7ad0 0xc00000000018a570 - 0xc000001fea6e7b40 0xc000000000028e5c - 0xc000001fea6e7b60 0xc0000000000a7168 - 0xc000001fea6e7bd0 0xc0000000000ac9b8 - 0xc000001fea6e7c80 0xc00000000012d6c8 - 0xc000001fea6e7d20 0xc00000000012da28 - 0xc000001fea6e7db0 0xc0000000001366f4 - 0xc000001fea6e7e20 0xc00000000000b65c + But with panic cpu stuck inside OPAL, linux never recovers/reboot. :: + + p0 c1 t0 + NIA : 0x000000003001dd3c <.time_wait+0x64> + CFAR : 0x000000003001dce4 <.time_wait+0xc> + MSR : 0x9000000002803002 + LR : 0x000000003002ecf8 <.ipmi_queue_msg_sync+0xec> + + STACK: SP NIA + 0x0000000031c236e0 0x0000000031c23760 (big-endian) + 0x0000000031c23760 0x000000003002ecf8 <.ipmi_queue_msg_sync+0xec> + 0x0000000031c237f0 0x00000000300aa5f8 <.hiomap_queue_msg_sync+0x7c> + 0x0000000031c23880 0x00000000300aaadc <.hiomap_window_move+0x150> + 0x0000000031c23950 0x00000000300ab1d8 <.ipmi_hiomap_write+0xcc> + 0x0000000031c23a90 0x00000000300a7b18 <.blocklevel_raw_write+0xbc> + 0x0000000031c23b30 0x00000000300a7c34 <.blocklevel_write+0xfc> + 0x0000000031c23bf0 0x0000000030030be0 <.flash_nvram_write+0xd4> + 0x0000000031c23c90 0x000000003002c128 <.opal_write_nvram+0xd0> + 0x0000000031c23d20 0x00000000300051e4 + 0xc000001fea6e7870 0xc0000000000a9060 + 0xc000001fea6e78c0 0xc000000000030b84 + 0xc000001fea6e7960 0xc0000000000310b0 + 0xc000001fea6e7990 0xc0000000004792d4 + 0xc000001fea6e7ad0 0xc00000000018a570 + 0xc000001fea6e7b40 0xc000000000028e5c + 0xc000001fea6e7b60 0xc0000000000a7168 + 0xc000001fea6e7bd0 0xc0000000000ac9b8 + 0xc000001fea6e7c80 0xc00000000012d6c8 + 0xc000001fea6e7d20 0xc00000000012da28 + 0xc000001fea6e7db0 0xc0000000001366f4 + 0xc000001fea6e7e20 0xc00000000000b65c This is because, there is a while loop towards the end of ipmi_queue_msg_sync() which keeps looping until "sync_msg" does not match @@ -174,6 +175,8 @@ Bug fixes included in this release are: normal scenario time_wait_ms() calls run pollers so that ipmi backend gets a chance to check ipmi response and set sync_msg to NULL. + .. code-block:: c + while (sync_msg == msg) time_wait_ms(10); diff --git a/doc/release-notes/skiboot-6.0.rst b/doc/release-notes/skiboot-6.0.rst index 309734557a81..6dae77d9f603 100644 --- a/doc/release-notes/skiboot-6.0.rst +++ b/doc/release-notes/skiboot-6.0.rst @@ -867,6 +867,7 @@ Debugging/Testing improvements ------------------------------ Since 6.0-rc1: + - mambo: Enable XER CA32 and OV32 bits on P9 POWER9 adds 32 bit carry and overflow bits to the XER, but we need to diff --git a/doc/release-notes/skiboot-6.2.2.rst b/doc/release-notes/skiboot-6.2.2.rst index 7326ebd673c2..e34841ab76c3 100644 --- a/doc/release-notes/skiboot-6.2.2.rst +++ b/doc/release-notes/skiboot-6.2.2.rst @@ -1,8 +1,8 @@ .. _skiboot-6.2.2: -============== +============= skiboot-6.2.2 -============== +============= skiboot 6.2.2 was released on Wednesday March 6th, 2019. It replaces :ref:`skiboot-6.2.1` as the current stable release in the 6.2.x series. @@ -27,7 +27,7 @@ powercap limit. ASTBMC -===== +====== - astbmc: Enable IPMI HIOMAP for AMI platforms Required for Habanero, Palmetto and Romulus. @@ -146,6 +146,7 @@ BMC communication bt_add_ipmi_msg_head() adds message to top of the list. If bt message list is not empty then: + - if bt_idle() is true then we will endup sending message to BMC before getting response from BMC for inflight message. Looks like on some BMC implementation this results in message timeout. diff --git a/doc/release-notes/skiboot-6.2.4.rst b/doc/release-notes/skiboot-6.2.4.rst index c6913fd483cd..bba9ebb5e344 100644 --- a/doc/release-notes/skiboot-6.2.4.rst +++ b/doc/release-notes/skiboot-6.2.4.rst @@ -1,8 +1,8 @@ .. _skiboot-6.2.4: -============== +============= skiboot-6.2.4 -============== +============= skiboot 6.2.4 was released on Thursday May 9th, 2019. It replaces :ref:`skiboot-6.2.3` as the current stable release in the 6.2.x series. @@ -18,7 +18,7 @@ Bug fixes included in this release are: for flash even if the BMC is not current ready to service flash requests. On the assumption that it will become ready, retry for several minutes to cover a BMC reboot cycle and *eventually* rather than - *immediately* crash out with: + *immediately* crash out with: :: [ 269.549748] reboot: Restarting system [ 390.297462587,5] OPAL: Reboot request... @@ -74,37 +74,37 @@ Bug fixes included in this release are: Initialising raw flash lead to a dead assignment to rc. Check the return code and take the failure path as necessary. Both before and after the fix we see output along the lines of the following when flash_init() - fails: - - [ 53.283182881,7] IRQ: Registering 0800..0ff7 ops @0x300d4b98 (data 0x3052b9d8) - [ 53.283184335,7] IRQ: Registering 0ff8..0fff ops @0x300d4bc8 (data 0x3052b9d8) - [ 53.283185513,7] PHB#0000: Initializing PHB... - [ 53.288260827,4] FLASH: Can't load resource id:0. No system flash found - [ 53.288354442,4] FLASH: Can't load resource id:1. No system flash found - [ 53.342933439,3] CAPP: Error loading ucode lid. index=200ea - [ 53.462749486,2] NVRAM: Failed to load - [ 53.462819095,2] NVRAM: Failed to load - [ 53.462894236,2] NVRAM: Failed to load - [ 53.462967071,2] NVRAM: Failed to load - [ 53.463033077,2] NVRAM: Failed to load - [ 53.463144847,2] NVRAM: Failed to load - - Eventually followed by: - - [ 57.216942479,5] INIT: platform wait for kernel load failed - [ 57.217051132,5] INIT: Assuming kernel at 0x20000000 - [ 57.217127508,3] INIT: ELF header not found. Assuming raw binary. - [ 57.217249886,2] NVRAM: Failed to load - [ 57.221294487,0] FATAL: Kernel is zeros, can't execute! - [ 57.221397429,0] Assert fail: core/init.c:615:0 - [ 57.221471414,0] Aborting! - CPU 0028 Backtrace: - S: 0000000031d43c60 R: 000000003001b274 ._abort+0x4c - S: 0000000031d43ce0 R: 000000003001b2f0 .assert_fail+0x34 - S: 0000000031d43d60 R: 0000000030014814 .load_and_boot_kernel+0xae4 - S: 0000000031d43e30 R: 0000000030015164 .main_cpu_entry+0x680 - S: 0000000031d43f00 R: 0000000030002718 boot_entry+0x1c0 - --- OPAL boot --- + fails: :: + + [ 53.283182881,7] IRQ: Registering 0800..0ff7 ops @0x300d4b98 (data 0x3052b9d8) + [ 53.283184335,7] IRQ: Registering 0ff8..0fff ops @0x300d4bc8 (data 0x3052b9d8) + [ 53.283185513,7] PHB#0000: Initializing PHB... + [ 53.288260827,4] FLASH: Can't load resource id:0. No system flash found + [ 53.288354442,4] FLASH: Can't load resource id:1. No system flash found + [ 53.342933439,3] CAPP: Error loading ucode lid. index=200ea + [ 53.462749486,2] NVRAM: Failed to load + [ 53.462819095,2] NVRAM: Failed to load + [ 53.462894236,2] NVRAM: Failed to load + [ 53.462967071,2] NVRAM: Failed to load + [ 53.463033077,2] NVRAM: Failed to load + [ 53.463144847,2] NVRAM: Failed to load + + Eventually followed by: :: + + [ 57.216942479,5] INIT: platform wait for kernel load failed + [ 57.217051132,5] INIT: Assuming kernel at 0x20000000 + [ 57.217127508,3] INIT: ELF header not found. Assuming raw binary. + [ 57.217249886,2] NVRAM: Failed to load + [ 57.221294487,0] FATAL: Kernel is zeros, can't execute! + [ 57.221397429,0] Assert fail: core/init.c:615:0 + [ 57.221471414,0] Aborting! + CPU 0028 Backtrace: + S: 0000000031d43c60 R: 000000003001b274 ._abort+0x4c + S: 0000000031d43ce0 R: 000000003001b2f0 .assert_fail+0x34 + S: 0000000031d43d60 R: 0000000030014814 .load_and_boot_kernel+0xae4 + S: 0000000031d43e30 R: 0000000030015164 .main_cpu_entry+0x680 + S: 0000000031d43f00 R: 0000000030002718 boot_entry+0x1c0 + --- OPAL boot --- Analysis of the execution paths suggests we'll always "safely" end this way due the setup sequence for the blocklevel callbacks in flash_init() @@ -143,19 +143,19 @@ Bug fixes included in this release are: shows no thread error reported in TFMR register. Without this patch the console event show TFMR with no thread error: - (DEC parity error TFMR[59] injection) + (DEC parity error TFMR[59] injection) :: - [ 53.737572] Severe Hypervisor Maintenance interrupt [Recovered] - [ 53.737596] Error detail: Timer facility experienced an error - [ 53.737611] HMER: 0840000000000000 - [ 53.737621] TFMR: 3212000870e04000 + [ 53.737572] Severe Hypervisor Maintenance interrupt [Recovered] + [ 53.737596] Error detail: Timer facility experienced an error + [ 53.737611] HMER: 0840000000000000 + [ 53.737621] TFMR: 3212000870e04000 - After this patch it shows old TFMR value on host console: + After this patch it shows old TFMR value on host console: :: - [ 2302.267271] Severe Hypervisor Maintenance interrupt [Recovered] - [ 2302.267305] Error detail: Timer facility experienced an error - [ 2302.267320] HMER: 0840000000000000 - [ 2302.267330] TFMR: 3212000870e14010 + [ 2302.267271] Severe Hypervisor Maintenance interrupt [Recovered] + [ 2302.267305] Error detail: Timer facility experienced an error + [ 2302.267320] HMER: 0840000000000000 + [ 2302.267330] TFMR: 3212000870e14010 - libflash/ipmi-hiomap: Fix blocks count issue @@ -163,11 +163,12 @@ Bug fixes included in this release are: If data size is not block aligned then we endup sending block count less than actual data. BMC will write partial data to flash memory. - Sample log : - [ 594.388458416,7] HIOMAP: Marked flash dirty at 0x42010 for 8 - [ 594.398756487,7] HIOMAP: Flushed writes - [ 594.409596439,7] HIOMAP: Marked flash dirty at 0x42018 for 3970 - [ 594.419897507,7] HIOMAP: Flushed writes + Sample log :: + + [ 594.388458416,7] HIOMAP: Marked flash dirty at 0x42010 for 8 + [ 594.398756487,7] HIOMAP: Flushed writes + [ 594.409596439,7] HIOMAP: Marked flash dirty at 0x42018 for 3970 + [ 594.419897507,7] HIOMAP: Flushed writes In this case HIOMAP sent data with block count=0 and hence BMC didn't flush data to flash. @@ -180,37 +181,37 @@ Bug fixes included in this release are: pnv_platform_error_reboot() path due to unrecoverable hmi event, the panic cpu gets stuck in OPAL inside ipmi_queue_msg_sync(). At this time, rest all other cpus are in smp_handle_nmi_ipi() waiting for panic cpu to proceed. - But with panic cpu stuck inside OPAL, linux never recovers/reboot. - - p0 c1 t0 - NIA : 0x000000003001dd3c <.time_wait+0x64> - CFAR : 0x000000003001dce4 <.time_wait+0xc> - MSR : 0x9000000002803002 - LR : 0x000000003002ecf8 <.ipmi_queue_msg_sync+0xec> - - STACK: SP NIA - 0x0000000031c236e0 0x0000000031c23760 (big-endian) - 0x0000000031c23760 0x000000003002ecf8 <.ipmi_queue_msg_sync+0xec> - 0x0000000031c237f0 0x00000000300aa5f8 <.hiomap_queue_msg_sync+0x7c> - 0x0000000031c23880 0x00000000300aaadc <.hiomap_window_move+0x150> - 0x0000000031c23950 0x00000000300ab1d8 <.ipmi_hiomap_write+0xcc> - 0x0000000031c23a90 0x00000000300a7b18 <.blocklevel_raw_write+0xbc> - 0x0000000031c23b30 0x00000000300a7c34 <.blocklevel_write+0xfc> - 0x0000000031c23bf0 0x0000000030030be0 <.flash_nvram_write+0xd4> - 0x0000000031c23c90 0x000000003002c128 <.opal_write_nvram+0xd0> - 0x0000000031c23d20 0x00000000300051e4 - 0xc000001fea6e7870 0xc0000000000a9060 - 0xc000001fea6e78c0 0xc000000000030b84 - 0xc000001fea6e7960 0xc0000000000310b0 - 0xc000001fea6e7990 0xc0000000004792d4 - 0xc000001fea6e7ad0 0xc00000000018a570 - 0xc000001fea6e7b40 0xc000000000028e5c - 0xc000001fea6e7b60 0xc0000000000a7168 - 0xc000001fea6e7bd0 0xc0000000000ac9b8 - 0xc000001fea6e7c80 0xc00000000012d6c8 - 0xc000001fea6e7d20 0xc00000000012da28 - 0xc000001fea6e7db0 0xc0000000001366f4 - 0xc000001fea6e7e20 0xc00000000000b65c + But with panic cpu stuck inside OPAL, linux never recovers/reboot. :: + + p0 c1 t0 + NIA : 0x000000003001dd3c <.time_wait+0x64> + CFAR : 0x000000003001dce4 <.time_wait+0xc> + MSR : 0x9000000002803002 + LR : 0x000000003002ecf8 <.ipmi_queue_msg_sync+0xec> + + STACK: SP NIA + 0x0000000031c236e0 0x0000000031c23760 (big-endian) + 0x0000000031c23760 0x000000003002ecf8 <.ipmi_queue_msg_sync+0xec> + 0x0000000031c237f0 0x00000000300aa5f8 <.hiomap_queue_msg_sync+0x7c> + 0x0000000031c23880 0x00000000300aaadc <.hiomap_window_move+0x150> + 0x0000000031c23950 0x00000000300ab1d8 <.ipmi_hiomap_write+0xcc> + 0x0000000031c23a90 0x00000000300a7b18 <.blocklevel_raw_write+0xbc> + 0x0000000031c23b30 0x00000000300a7c34 <.blocklevel_write+0xfc> + 0x0000000031c23bf0 0x0000000030030be0 <.flash_nvram_write+0xd4> + 0x0000000031c23c90 0x000000003002c128 <.opal_write_nvram+0xd0> + 0x0000000031c23d20 0x00000000300051e4 + 0xc000001fea6e7870 0xc0000000000a9060 + 0xc000001fea6e78c0 0xc000000000030b84 + 0xc000001fea6e7960 0xc0000000000310b0 + 0xc000001fea6e7990 0xc0000000004792d4 + 0xc000001fea6e7ad0 0xc00000000018a570 + 0xc000001fea6e7b40 0xc000000000028e5c + 0xc000001fea6e7b60 0xc0000000000a7168 + 0xc000001fea6e7bd0 0xc0000000000ac9b8 + 0xc000001fea6e7c80 0xc00000000012d6c8 + 0xc000001fea6e7d20 0xc00000000012da28 + 0xc000001fea6e7db0 0xc0000000001366f4 + 0xc000001fea6e7e20 0xc00000000000b65c This is because, there is a while loop towards the end of ipmi_queue_msg_sync() which keeps looping until "sync_msg" does not match @@ -218,6 +219,8 @@ Bug fixes included in this release are: normal scenario time_wait_ms() calls run pollers so that ipmi backend gets a chance to check ipmi response and set sync_msg to NULL. + .. code-block:: c + while (sync_msg == msg) time_wait_ms(10); From patchwork Fri May 31 06:12:57 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108098 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZGk0HBhz9s00 for ; Fri, 31 May 2019 16:26:38 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZGj6KtkzDqcJ for ; Fri, 31 May 2019 16:26:37 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0M28tgzDqXW for ; Fri, 31 May 2019 16:14:11 +1000 (AEST) Received: from pps.filterd (m0098417.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V668T5145217 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e35.co.us.ibm.com (e35.co.us.ibm.com [32.97.110.153]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvp63v0v-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e35.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:06 +0100 Received: from b03cxnp08027.gho.boulder.ibm.com (9.17.130.19) by e35.co.us.ibm.com (192.168.1.135) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp08027.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E46B26608008 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 48EBDBE059 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id DA564BE054 for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:03 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 6964B507BC7; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:57 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0012-0000-0000-0000173DDCFB X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0013-0000-0000-00005778F808 Message-Id: <20190531061351.22973-57-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=3 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 056/110] doc: Document OPAL_DUMP_* calls X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- .../opal-dump-81-82-83-84-94-101-102.rst | 293 ++++++++++++++++++ doc/opal-api/opal-dump-region-101-102.rst | 100 ------ doc/opal-api/opal-poll-events.rst | 9 +- 3 files changed, 299 insertions(+), 103 deletions(-) create mode 100644 doc/opal-api/opal-dump-81-82-83-84-94-101-102.rst delete mode 100644 doc/opal-api/opal-dump-region-101-102.rst diff --git a/doc/opal-api/opal-dump-81-82-83-84-94-101-102.rst b/doc/opal-api/opal-dump-81-82-83-84-94-101-102.rst new file mode 100644 index 000000000000..04dc8a0448f5 --- /dev/null +++ b/doc/opal-api/opal-dump-81-82-83-84-94-101-102.rst @@ -0,0 +1,293 @@ +.. _opal-dumps: + +========== +OPAL Dumps +========== + +.. code-block:: c + + #define OPAL_REGISTER_DUMP_REGION 101 + #define OPAL_UNREGISTER_DUMP_REGION 102 + + int64_t opal_register_dump_region(uint32_t id, uint64_t addr, uint64_t size); + int64_t opal_unregister_dump_region(uint32_t id); + +In the event of crashes, some service processors and firmware support gathering +a limited amount of memory from a limited number of memory regions to save into +a debug dump that can be useful for firmware and operating system developers +in diagnosing problems. Typically, firmware and kernel log buffers are useful to +save in a dump. + +An OS can register a memory region with :ref:`OPAL_REGISTER_DUMP_REGION` and should, +when the region is no longer valid (e.g. when kexec()ing), it should unregister the +region with :ref:`OPAL_UNREGISTER_DUMP_REGION`. + +An OS will be made aware of a dump being available through :ref:`OPAL_EVENT_DUMP_AVAIL` +being set from a :ref:`OPAL_POLL_EVENTS` call. + +Retreiving dumps from a service processor can also be performed using the +:ref:`OPAL_DUMP_INFO`, :ref:`OPAL_DUMP_INFO2`, :ref:`OPAL_DUMP_READ`, +and :ref:`OPAL_DUMP_RESEND` calls. Dumps are identified by a ``uint32_t``, and +once a dump is acknowledged, this ID can be re-used. + +Dumps can also be initiated by OPAL through the :ref:`OPAL_DUMP_INIT` call, which +will request that the service processor performs the requested type of dump. + +A call to :ref:`OPAL_DUMP_ACK` indicates to the service processor that we have +retreived/acknowledged the dump and the service processor can free up the storage +used by it. + +.. code-block:: c + + #define OPAL_DUMP_INIT 81 + #define OPAL_DUMP_INFO 82 + #define OPAL_DUMP_READ 83 + #define OPAL_DUMP_ACK 84 + #define OPAL_DUMP_RESEND 91 + #define OPAL_DUMP_INFO2 94 + + int64_t opal_dump_init(uint8_t dump_type); + int64_t opal_dump_info(uint32_t *dump_id, uint32_t *dump_size); + int64_t opal_dump_read(uint32_t dump_id, struct opal_sg_list *list); + int64_t opal_dump_ack(uint32_t dump_id); + int64_t opal_dump_resend_notification(void); + int64_t opal_dump_info2(uint32_t *dump_id, uint32_t *dump_size, uint32_t *dump_type); + + +.. _OPAL_REGISTER_DUMP_REGION: + +OPAL_REGISTER_DUMP_REGION +========================= + +.. code-block:: c + + #define OPAL_REGISTER_DUMP_REGION 101 + + int64_t opal_register_dump_region(uint32_t id, uint64_t addr, uint64_t size); + +This call is used to register regions of memory for a service processor to capture +when the host crashes. + +e.g. if an assert is hit in OPAL, a service processor will copy the region of +memory into some kind of crash dump for further analysis. + +This is an OPTIONAL feature that may be unsupported, the host OS should use an +:ref:`OPAL_CHECK_TOKEN` call to find out if :ref:`OPAL_REGISTER_DUMP_REGION` is supported. + +:ref:`OPAL_REGISTER_DUMP_REGION` accepts 3 parameters: + +- region ID +- address +- length + +There is a range of region IDs that can be used by the host OS. A host OS should +start from OPAL_DUMP_REGION_HOST_END and work down if it wants to add a not well +defined region to dump. Currently the only well defined region is for the host +OS log buffer (e.g. dmesg on linux). :: + + /* + * Dump region ID range usable by the OS + */ + #define OPAL_DUMP_REGION_HOST_START 0x80 + #define OPAL_DUMP_REGION_LOG_BUF 0x80 + #define OPAL_DUMP_REGION_HOST_END 0xFF + +:ref:`OPAL_REGISTER_DUMP_REGION` will return :ref:`OPAL_UNSUPPORTED` if the call is present but +the system doesn't support registering regions to be dumped. + +In the event of being passed an invalid region ID, :ref:`OPAL_REGISTER_DUMP_REGION` will +return :ref:`OPAL_PARAMETER`. + +Systems likely have a limit as to how many regions they can support being dumped. If +this limit is reached, :ref:`OPAL_REGISTER_DUMP_REGION` will return :ref:`OPAL_INTERNAL_ERROR`. + +BUGS +---- +Some skiboot versions incorrectly returned :ref:`OPAL_SUCCESS` in the case of +:ref:`OPAL_REGISTER_DUMP_REGION` being supported on a platform (so the call was present) +but the call being unsupported for some reason (e.g. on an IBM POWER7 machine). + +See also: :ref:`OPAL_UNREGISTER_DUMP_REGION` + +.. _OPAL_UNREGISTER_DUMP_REGION: + +OPAL_UNREGISTER_DUMP_REGION +=========================== + +.. code-block:: c + + #define OPAL_UNREGISTER_DUMP_REGION 102 + + int64_t opal_unregister_dump_region(uint32_t id); + +While :ref:`OPAL_REGISTER_DUMP_REGION` registers a region, :ref:`OPAL_UNREGISTER_DUMP_REGION` +will unregister a region by region ID. + +:ref:`OPAL_UNREGISTER_DUMP_REGION` takes one argument: the region ID. + +A host OS should check :ref:`OPAL_UNREGISTER_DUMP_REGION` is supported through a call to +:ref:`OPAL_CHECK_TOKEN`. + +If :ref:`OPAL_UNREGISTER_DUMP_REGION` is called on a system where the call is present but +unsupported, it will return :ref:`OPAL_UNSUPPORTED`. + +BUGS +---- +Some skiboot versions incorrectly returned :ref:`OPAL_SUCCESS` in the case of +:ref:`OPAL_UNREGISTER_DUMP_REGION` being supported on a platform (so the call was present) +but the call being unsupported for some reason (e.g. on an IBM POWER7 machine). + +.. _OPAL_DUMP_INIT: + +OPAL_DUMP_INIT +============== + +.. code-block:: c + + #define OPAL_DUMP_INIT 81 + + #define DUMP_TYPE_FSP 0x01 + #define DUMP_TYPE_SYS 0x02 + #define DUMP_TYPE_SMA 0x03 + + int64_t opal_dump_init(uint8_t dump_type); + +Ask the service processor to initiate a dump. Currently, only ``DUMP_TYPE_FSP`` +is supported. + +Currently only implemented on FSP based systems. Use :ref:`OPAL_CHECK_TOKEN` to +ensure the call is valid. + +Returns +------- +:ref:`OPAL_SUCCESS` + Dump initiated +:ref:`OPAL_PARAMETER` + Unsupported dump type. Currently only ``DUMP_TYPE_FSP`` is supported and + only on FSP based platforms. +:ref:`OPAL_INTERNAL_ERROR` + Failed to ask service processor to initiated dump. + +.. _OPAL_DUMP_INFO: + +OPAL_DUMP_INFO +============== + +.. code-block:: c + + #define OPAL_DUMP_INFO 82 + + int64_t opal_dump_info(uint32_t *dump_id, uint32_t *dump_size); + +Obsolete, use :ref:`OPAL_DUMP_INFO2` instead. + +No upstream Linux code ever used :ref:`OPAL_DUMP_INFO`, although early PowerKVM +trees did. :ref:`OPAL_DUMP_INFO` is implemented as a wrapper around +:ref:`OPAL_DUMP_INFO2`. + +.. _OPAL_DUMP_READ: + +OPAL_DUMP_READ +============== + +.. code-block:: c + + #define OPAL_DUMP_READ 83 + + int64_t opal_dump_read(uint32_t dump_id, struct opal_sg_list *list); + +Read ``dump_id`` dump from the service processor into memory. + + +Returns +------- +:ref:`OPAL_INTERNAL_ERROR` + Invalid Dump ID or internal error. +:ref:`OPAL_PARAMETER` + Insuffcient space to store dump. +:ref:`OPAL_BUSY_EVENT` + Fetching dump, call :ref:`OPAL_POLL_EVENTS` to crank the state machine, + and call :ref:`OPAL_DUMP_READ` again until neither :ref:`OPAL_BUSY_EVENT` + nor :ref:`OPAL_BUSY` are returned. +:ref:`OPAL_PARTIAL` + Only part of the dump was read. +:ref:`OPAL_SUCCESS` + Dump successfully read. + +.. _OPAL_DUMP_ACK: + +OPAL_DUMP_ACK +============= + +.. code-block:: c + + #define OPAL_DUMP_ACK 84 + + int64_t opal_dump_ack(uint32_t dump_id); + +Acknowledge the dump to the service processor. This means the service processor +can re-claim the storage space used by the dump. Effectively, this is an +``unlink`` style operation. + +Returns +------- +:ref:`OPAL_SUCCESS` + Dump successfully acknowledged. +:ref:`OPAL_INTERNAL_ERROR` + Failed to acknowledge the dump, e.g. could not communicate with service + processor. +:ref:`OPAL_PARAMETER` + Invalid dump ID. + + +.. _OPAL_DUMP_RESEND: + +OPAL_DUMP_RESEND +================ + +.. code-block:: c + + #define OPAL_DUMP_RESEND 91 + + int64_t opal_dump_resend_notification(void); + +Resend notification to the OS if there is a dump available. This will +cause OPAL to check if a dump is available and set the +:ref:`OPAL_EVENT_DUMP_AVAIL` bit in the next :ref:`OPAL_POLL_EVENTS` call. + +Returns +------- +:ref:`OPAL_SUCCESS` + Successfully reset :ref:`OPAL_EVENT_DUMP_AVAIL` bit. + +In future, this may return other standard OPAL error codes. + +.. _OPAL_DUMP_INFO2: + +OPAL_DUMP_INFO2 +=============== + +.. code-block:: c + + #define OPAL_DUMP_INFO2 94 + + #define DUMP_TYPE_FSP 0x01 + #define DUMP_TYPE_SYS 0x02 + #define DUMP_TYPE_SMA 0x03 + + int64_t opal_dump_info2(uint32_t *dump_id, uint32_t *dump_size, uint32_t *dump_type); + +Retreives information about a dump, notably it's ``dump_id``, size, and type. +Call this after the :ref:`OPAL_EVENT_DUMP_AVAIL` bit is set from a +:ref:`OPAL_POLL_EVENTS` call. It will retreive the information on the *next* +dump to be retreived and/or ACKed, even though there may be more than one dump +available for retreiving. + +This call replaces :ref:`OPAL_DUMP_INFO`. + +Returns +------- +:ref:`OPAL_SUCCESS` + Information retreived. +:ref:`OPAL_INTERNAL_ERROR` + No dump available or internal error. diff --git a/doc/opal-api/opal-dump-region-101-102.rst b/doc/opal-api/opal-dump-region-101-102.rst deleted file mode 100644 index dca63f6e5c9a..000000000000 --- a/doc/opal-api/opal-dump-region-101-102.rst +++ /dev/null @@ -1,100 +0,0 @@ -================= -OPAL Dump Regions -================= - -.. code-block:: c - - #define OPAL_REGISTER_DUMP_REGION 101 - #define OPAL_UNREGISTER_DUMP_REGION 102 - - int64_t opal_register_dump_region(uint32_t id, uint64_t addr, uint64_t size); - int64_t opal_unregister_dump_region(uint32_t id); - -In the event of crashes, some service processors and firmware support gathering -a limited amount of memory from a limited number of memory regions to save into -a debug dump that can be useful for firmware and operating system developers -in diagnosing problems. Typically, firmware and kernel log buffers are useful to -save in a dump. - -.. _OPAL_REGISTER_DUMP_REGION: - -OPAL_REGISTER_DUMP_REGION -========================= - -.. code-block:: c - - #define OPAL_REGISTER_DUMP_REGION 101 - - int64_t opal_register_dump_region(uint32_t id, uint64_t addr, uint64_t size); - -This call is used to register regions of memory for a service processor to capture -when the host crashes. - -e.g. if an assert is hit in OPAL, a service processor will copy the region of -memory into some kind of crash dump for further analysis. - -This is an OPTIONAL feature that may be unsupported, the host OS should use an -:ref:`OPAL_CHECK_TOKEN` call to find out if :ref:`OPAL_REGISTER_DUMP_REGION` is supported. - -:ref:`OPAL_REGISTER_DUMP_REGION` accepts 3 parameters: - -- region ID -- address -- length - -There is a range of region IDs that can be used by the host OS. A host OS should -start from OPAL_DUMP_REGION_HOST_END and work down if it wants to add a not well -defined region to dump. Currently the only well defined region is for the host -OS log buffer (e.g. dmesg on linux). :: - - /* - * Dump region ID range usable by the OS - */ - #define OPAL_DUMP_REGION_HOST_START 0x80 - #define OPAL_DUMP_REGION_LOG_BUF 0x80 - #define OPAL_DUMP_REGION_HOST_END 0xFF - -:ref:`OPAL_REGISTER_DUMP_REGION` will return :ref:`OPAL_UNSUPPORTED` if the call is present but -the system doesn't support registering regions to be dumped. - -In the event of being passed an invalid region ID, :ref:`OPAL_REGISTER_DUMP_REGION` will -return :ref:`OPAL_PARAMETER`. - -Systems likely have a limit as to how many regions they can support being dumped. If -this limit is reached, :ref:`OPAL_REGISTER_DUMP_REGION` will return :ref:`OPAL_INTERNAL_ERROR`. - -BUGS ----- -Some skiboot versions incorrectly returned :ref:`OPAL_SUCCESS` in the case of -:ref:`OPAL_REGISTER_DUMP_REGION` being supported on a platform (so the call was present) -but the call being unsupported for some reason (e.g. on an IBM POWER7 machine). - -See also: :ref:`OPAL_UNREGISTER_DUMP_REGION` - -.. _OPAL_UNREGISTER_DUMP_REGION: - -OPAL_UNREGISTER_DUMP_REGION -=========================== - -.. code-block:: c - - #define OPAL_UNREGISTER_DUMP_REGION 102 - - int64_t opal_unregister_dump_region(uint32_t id); - -While :ref:`OPAL_REGISTER_DUMP_REGION` registers a region, :ref:`OPAL_UNREGISTER_DUMP_REGION` -will unregister a region by region ID. - -:ref:`OPAL_UNREGISTER_DUMP_REGION` takes one argument: the region ID. - -A host OS should check :ref:`OPAL_UNREGISTER_DUMP_REGION` is supported through a call to -:ref:`OPAL_CHECK_TOKEN`. - -If :ref:`OPAL_UNREGISTER_DUMP_REGION` is called on a system where the call is present but -unsupported, it will return :ref:`OPAL_UNSUPPORTED`. - -BUGS ----- -Some skiboot versions incorrectly returned :ref:`OPAL_SUCCESS` in the case of -:ref:`OPAL_UNREGISTER_DUMP_REGION` being supported on a platform (so the call was present) -but the call being unsupported for some reason (e.g. on an IBM POWER7 machine). diff --git a/doc/opal-api/opal-poll-events.rst b/doc/opal-api/opal-poll-events.rst index 71ca21bfc3a4..c4bf24dcd8d1 100644 --- a/doc/opal-api/opal-poll-events.rst +++ b/doc/opal-api/opal-poll-events.rst @@ -75,9 +75,12 @@ OPAL_EVENT_PCI_ERROR = 0x200 ---------------------------- TODO +.. _OPAL_EVENT_DUMP_AVAIL: + OPAL_EVENT_DUMP_AVAIL = 0x400 ----------------------------- -Signifies that there is a pending system dump available. See OPAL_DUMP suite -of calls for details. :: +Signifies that there is a pending system dump available. See :ref:`opal-dumps` suite +of calls for details. - OPAL_EVENT_MSG_PENDING = 0x800, +OPAL_EVENT_MSG_PENDING = 0x800 +------------------------------ From patchwork Fri May 31 06:12:58 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108104 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZJ53sfwz9sDX for ; Fri, 31 May 2019 16:27:49 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZJ52PJ6zDqK6 for ; Fri, 31 May 2019 16:27:49 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N1J3nzDqXs for ; Fri, 31 May 2019 16:14:11 +1000 (AEST) Received: from pps.filterd (m0098404.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64H94042508 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e36.co.us.ibm.com (e36.co.us.ibm.com [32.97.110.154]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4vhd6h-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e36.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b03cxnp08027.gho.boulder.ibm.com (9.17.130.19) by e36.co.us.ibm.com (192.168.1.136) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp08027.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4pm28770598 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 532FCBE056 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 19F93BE05F for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 6DE80507BC9; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:58 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0020-0000-0000-00000EF2737D X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0021-0000-0000-000066081ED6 Message-Id: <20190531061351.22973-58-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=966 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 057/110] Add missing 5.4.9 release notes X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/release-notes/skiboot-5.4.9.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 doc/release-notes/skiboot-5.4.9.rst diff --git a/doc/release-notes/skiboot-5.4.9.rst b/doc/release-notes/skiboot-5.4.9.rst new file mode 100644 index 000000000000..63a202e902ba --- /dev/null +++ b/doc/release-notes/skiboot-5.4.9.rst @@ -0,0 +1,16 @@ +.. _skiboot-5.4.9: + +============= +skiboot-5.4.9 +============= + +skiboot-5.4.9 was released on Friday January 5th, 2018. It replaces +:ref:`skiboot-5.4.8` as the current stable release in the 5.4.x series. + +Over :ref:`skiboot-5.4.8`, we have one new feature: + +- Parse IPL FW feature settings + + Add parsing for the firmware feature flags in the HDAT. This + indicates the settings of various parameters which are set at IPL time + by firmware. From patchwork Fri May 31 06:12:59 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108101 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZHS0flqz9s00 for ; Fri, 31 May 2019 16:27:16 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZHR6pLczDqZb for ; Fri, 31 May 2019 16:27:15 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N1wmhzDqYL for ; Fri, 31 May 2019 16:14:11 +1000 (AEST) Received: from pps.filterd (m0098396.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V648G8037916 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e36.co.us.ibm.com (e36.co.us.ibm.com [32.97.110.154]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4v1d5g-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e36.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b03cxnp07029.gho.boulder.ibm.com (9.17.130.16) by e36.co.us.ibm.com (192.168.1.136) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b03ledav001.gho.boulder.ibm.com (b03ledav001.gho.boulder.ibm.com [9.17.130.232]) by b03cxnp07029.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4GN11927858 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 57AF46E053 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 20D5A6E04C for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav001.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 72FD7507BCA; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:12:59 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0020-0000-0000-00000EF2737C X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0021-0000-0000-000066081ED5 Message-Id: <20190531061351.22973-59-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=13 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 058/110] skiboot 6.0.3 release notes X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith (cherry picked from commit 8cdc58924f8d200e62bf91a57feb39f6f12e41d4) Signed-off-by: Stewart Smith --- doc/release-notes/skiboot-6.0.3.rst | 53 +++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 doc/release-notes/skiboot-6.0.3.rst diff --git a/doc/release-notes/skiboot-6.0.3.rst b/doc/release-notes/skiboot-6.0.3.rst new file mode 100644 index 000000000000..3f127da61ed3 --- /dev/null +++ b/doc/release-notes/skiboot-6.0.3.rst @@ -0,0 +1,53 @@ +.. _skiboot-6.0.3: + +============= +skiboot-6.0.3 +============= + +skiboot 6.0.3 was released on Wednesday May 23rd, 2018. It replaces +:ref:`skiboot-6.0.2` as the current stable release in the 6.0.x series. + +It is recommended that 6.0.3 be used instead of any previous 6.0.x version. + +Over :ref:`skiboot-6.0.3`, we have bug fixes related to i2c booting in +secure mode, and general functionality with a TPM present. These changes are: + +- p8-i2c: Remove force reset + + Force reset was added as an attempt to work around some issues with TPM + devices locking up their I2C bus. In that particular case the problem + was that the device would hold the SCL line down permanently due to a + device firmware bug. The force reset doesn't actually do anything to + alleviate the situation here, it just happens to reset the internal + master state enough to make the I2C driver appear to work until + something tries to access the bus again. + + On P9 systems with secure boot enabled there is the added problem + of the "diagostic mode" not being supported on I2C masters A,B,C and + D. Diagnostic mode allows the SCL and SDA lines to be driven directly + by software. Without this force reset is impossible to implement. + + This patch removes the force reset functionality entirely since: + + a) it doesn't do what it's supposed to, and + b) it's butt ugly code + + Additionally, turn p8_i2c_reset_engine() into p8_i2c_reset_port(). + There's no need to reset every port on a master in response to an + error that occurred on a specific port. + +- libstb/i2c-driver: Bump max timeout + + We have observed some TPMs clock streching the I2C bus for signifigant + amounts of time when processing commands. The same TPMs also have + errata that can result in permernantly locking up a bus in response to + an I2C transaction they don't understand. Using an excessively long + timeout to prevent this in the field. +- Add TPM timeout workaround + + Set the default timeout for any bus containing a TPM to one second. This + is needed to work around a bug in the firmware of certain TPMs that will + clock strech the I2C port the for up to a second. Additionally, when the + TPM is clock streching it responds to a STOP condition on the bus by + bricking itself. Clearing this error requires a hard power cycle of the + system since the TPM is powered by standby power. From patchwork Fri May 31 06:13:00 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108125 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZPB5Q7Rz9s00 for ; Fri, 31 May 2019 16:32:14 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZPB4GTSzDqSV for ; Fri, 31 May 2019 16:32:14 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N5YWvzDqZC for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098413.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V68bCb037877 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e36.co.us.ibm.com (e36.co.us.ibm.com [32.97.110.154]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxr105pb-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:08 -0400 Received: from localhost by e36.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b03cxnp08027.gho.boulder.ibm.com (9.17.130.19) by e36.co.us.ibm.com (192.168.1.136) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b03ledav004.gho.boulder.ibm.com (b03ledav004.gho.boulder.ibm.com [9.17.130.235]) by b03cxnp08027.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4xJ22806962 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b03ledav004.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 5FDCA7805F for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b03ledav004.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 26F957805C for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav004.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 7789E507BCB; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:00 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0020-0000-0000-00000EF2737E X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0021-0000-0000-000066081ED8 Message-Id: <20190531061351.22973-60-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=13 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=698 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 059/110] skiboot v6.0.12 release notes X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith (cherry picked from commit 450975e708bf8f4638f8c1811ecc21ea7e5ea298) Signed-off-by: Stewart Smith --- doc/release-notes/skiboot-6.0.12.rst | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 doc/release-notes/skiboot-6.0.12.rst diff --git a/doc/release-notes/skiboot-6.0.12.rst b/doc/release-notes/skiboot-6.0.12.rst new file mode 100644 index 000000000000..f647be2f4d12 --- /dev/null +++ b/doc/release-notes/skiboot-6.0.12.rst @@ -0,0 +1,24 @@ +.. _skiboot-6.0.12: + +============== +skiboot-6.0.12 +============== + +skiboot 6.0.12 was released on Monday November 12th, 2018. It replaces +:ref:`skiboot-6.0.11` as the current stable release in the 6.0.x series. + +It is recommended that 6.0.12 be used instead of any previous 6.0.x version +due to the bug fixes it contains. + +The bug fixes are: + +- hiomap: quieten warning on failing to move a window + + This isn't *necessarily* an error that we should complain loudly about. + If, for example, the BMC enforces the Read Only flag on a FFS partition, + opening a write window *should* fail, and we do indeed test this in + op-test. + + Thus we deal with the error in a well known path: returning an error + code and then it's eventually a userspace problem. +- libflash/ipmi-hiomap: Respect daemon presence and flash control From patchwork Fri May 31 06:13:01 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108102 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZHh0nrHz9s00 for ; Fri, 31 May 2019 16:27:28 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZHg6bmDzDqK6 for ; Fri, 31 May 2019 16:27:27 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N1dmhzDqYC for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098394.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64Jxu078514 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e31.co.us.ibm.com (e31.co.us.ibm.com [32.97.110.149]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stv42d088-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e31.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b03cxnp07029.gho.boulder.ibm.com (9.17.130.16) by e31.co.us.ibm.com (192.168.1.131) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp07029.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4pD41877736 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 8E1A3C605B for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 2A6E3C605A for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 7C1C4507BD0; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:01 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-8235-0000-0000-00000EA0F3AB X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-8236-0000-0000-000045C9C0EF Message-Id: <20190531061351.22973-61-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=13 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 060/110] skiboot 6.0.9 release notes X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith (cherry picked from commit 19484fa4338f84617ae8282f17b43d658afc3589) Signed-off-by: Stewart Smith --- doc/release-notes/skiboot-6.0.9.rst | 139 ++++++++++++++++++++++++++++ 1 file changed, 139 insertions(+) create mode 100644 doc/release-notes/skiboot-6.0.9.rst diff --git a/doc/release-notes/skiboot-6.0.9.rst b/doc/release-notes/skiboot-6.0.9.rst new file mode 100644 index 000000000000..87eb797843ff --- /dev/null +++ b/doc/release-notes/skiboot-6.0.9.rst @@ -0,0 +1,139 @@ +.. _skiboot-6.0.9: + +============= +skiboot-6.0.9 +============= + +skiboot 6.0.9 was released on Friday October 12th, 2018. It replaces +:ref:`skiboot-6.0.8` as the current stable release in the 6.0.x series. + +It is recommended that 6.0.9 be used instead of any previous 6.0.x version +due to the bug fixes it contains. + +The bug fixes are: + +- opal/hmi: Ignore debug trigger inject core FIR. + + Core FIR[60] is a side effect of the work around for the CI Vector Load + issue in DD2.1. Usually this gets delivered as HMI with HMER[17] where + Linux already ignores it. But it looks like in some cases we may happen + to see CORE_FIR[60] while we are already in Malfunction Alert HMI + (HMER[0]) due to other reasons e.g. CAPI recovery or NPU xstop. If that + happens then just ignore it instead of crashing kernel as not recoverable. + +- opal/hmi: Handle early HMIs on thread0 when secondaries are still in OPAL. + + When primary thread receives a CORE level HMI for timer facility errors + while secondaries are still in OPAL, thread 0 ends up in rendez-vous + waiting for secondaries to get into hmi handling. This is because OPAL + runs with MSR(EE=0) and hence HMIs are delayed on secondary threads until + they are given to Linux OS. Fix this by adding a check for secondary + state and force them in hmi handling by queuing job on secondary threads. + + I have tested this by injecting HDEC parity error very early during Linux + kernel boot. Recovery works fine for non-TB errors. But if TB is bad at + this very eary stage we already doomed. + + Without this patch we see: :: + + [ 285.046347408,7] OPAL: Start CPU 0x0843 (PIR 0x0843) -> 0x000000000000a83c + [ 285.051160609,7] OPAL: Start CPU 0x0844 (PIR 0x0844) -> 0x000000000000a83c + [ 285.055359021,7] HMI: Received HMI interrupt: HMER = 0x0840000000000000 + [ 285.055361439,7] HMI: [Loc: U78D3.ND1.WZS004A-P1-C48]: P:8 C:17 T:0: TFMR(2e12002870e14000) Timer Facility Error + [ 286.232183823,3] HMI: Rendez-vous stage 1 timeout, CPU 0x844 waiting for thread 1 (sptr=0000ccc1) + [ 287.409002056,3] HMI: Rendez-vous stage 1 timeout, CPU 0x844 waiting for thread 2 (sptr=0000ccc1) + [ 289.073820164,3] HMI: Rendez-vous stage 1 timeout, CPU 0x844 waiting for thread 3 (sptr=0000ccc1) + [ 290.250638683,3] HMI: Rendez-vous stage 1 timeout, CPU 0x844 waiting for thread 1 (sptr=0000ccc2) + [ 291.427456821,3] HMI: Rendez-vous stage 1 timeout, CPU 0x844 waiting for thread 2 (sptr=0000ccc2) + [ 293.092274807,3] HMI: Rendez-vous stage 1 timeout, CPU 0x844 waiting for thread 3 (sptr=0000ccc2) + [ 294.269092904,3] HMI: Rendez-vous stage 1 timeout, CPU 0x844 waiting for thread 1 (sptr=0000ccc3) + [ 295.445910944,3] HMI: Rendez-vous stage 1 timeout, CPU 0x844 waiting for thread 2 (sptr=0000ccc3) + [ 297.110728970,3] HMI: Rendez-vous stage 1 timeout, CPU 0x844 waiting for thread 3 (sptr=0000ccc3) + + After this patch: :: + + [ 259.401719351,7] OPAL: Start CPU 0x0841 (PIR 0x0841) -> 0x000000000000a83c + [ 259.406259572,7] OPAL: Start CPU 0x0842 (PIR 0x0842) -> 0x000000000000a83c + [ 259.410615534,7] OPAL: Start CPU 0x0843 (PIR 0x0843) -> 0x000000000000a83c + [ 259.415444519,7] OPAL: Start CPU 0x0844 (PIR 0x0844) -> 0x000000000000a83c + [ 259.419641401,7] HMI: Received HMI interrupt: HMER = 0x0840000000000000 + [ 259.419644124,7] HMI: [Loc: U78D3.ND1.WZS004A-P1-C48]: P:8 C:17 T:0: TFMR(2e12002870e04000) Timer Facility Error + [ 259.419650678,7] HMI: Sending hmi job to thread 1 + [ 259.419652744,7] HMI: Sending hmi job to thread 2 + [ 259.419653051,7] HMI: Received HMI interrupt: HMER = 0x0840000000000000 + [ 259.419654725,7] HMI: Sending hmi job to thread 3 + [ 259.419654916,7] HMI: Received HMI interrupt: HMER = 0x0840000000000000 + [ 259.419658025,7] HMI: Received HMI interrupt: HMER = 0x0840000000000000 + [ 259.419658406,7] HMI: [Loc: U78D3.ND1.WZS004A-P1-C48]: P:8 C:17 T:2: TFMR(2e12002870e04000) Timer Facility Error + [ 259.419663095,7] HMI: [Loc: U78D3.ND1.WZS004A-P1-C48]: P:8 C:17 T:3: TFMR(2e12002870e04000) Timer Facility Error + [ 259.419655234,7] HMI: [Loc: U78D3.ND1.WZS004A-P1-C48]: P:8 C:17 T:1: TFMR(2e12002870e04000) Timer Facility Error + [ 259.425109779,7] OPAL: Start CPU 0x0845 (PIR 0x0845) -> 0x000000000000a83c + [ 259.429870681,7] OPAL: Start CPU 0x0846 (PIR 0x0846) -> 0x000000000000a83c + [ 259.434549250,7] OPAL: Start CPU 0x0847 (PIR 0x0847) -> 0x000000000000a83c + +- hw/bt.c: quieten all the noisy BT/IPMI messages +- npu2: Use correct kill type for TCE invalidation + + kill_type is enum of OPAL_PCI_TCE_KILL_PAGES, OPAL_PCI_TCE_KILL_PE, + OPAL_PCI_TCE_KILL_ALL and phb4_tce_kill() gets it right but + npu2_tce_kill() uses OPAL_PCI_TCE_KILL which is an OPAL API token. + +- hw/npu2-opencapi: Fix setting of supported OpenCAPI templates + + In opal_npu_tl_set(), we made a typo that means the OPAL_NPU_TL_SET call + may not clear the enable bits for templates that were previously enabled + but are now disabled. + + Fix the typo so we clear NPU2_OTL_CONFIG1_TX_TEMP2_EN as well as + TEMP{1,3}_EN. + +- phb4: Workaround PHB errata with CFG write UR/CA errors + + If the PHB encounters a UR or CA status on a CFG write, it will + incorrectly freeze the wrong PE. Instead of using the PE# specified + in the CONFIG_ADDRESS register, it will use the PE# of whatever + MMIO occurred last. + + Work around this disabling freeze on such errors + +- phb4: Handle allocation errors in phb4_eeh_dump_regs() + + If the zalloc fails (and it can be a rather large allocation), + we will overwite memory at 0 instead of failing. + +- phb4: Don't try to access non-existent PEST entries + + In a POWER9 chip, some PHB4s have 256 PEs, some have 512. + + Currently, the diagnostics code retrieves 512 unconditionally, + which is wrong and causes us to incorrectly report bogus values + for the "high" PEs on the small PHBs. + + Use the actual number of implemented PEs instead + +- phb4: Don't probe a PHB if its garded + + Presently phb4_probe_stack() causes an exception while trying to probe + a PHB if its garded. This causes skiboot to go into a reboot loop with + following exception log: :: + + *********************************************** + Fatal MCE at 000000003006ecd4 .probe_phb4+0x570 + CFAR : 00000000300b98a0 + + Aborting! + CPU 0018 Backtrace: + S: 0000000031cc37e0 R: 000000003001a51c ._abort+0x4c + S: 0000000031cc3860 R: 0000000030028170 .exception_entry+0x180 + S: 0000000031cc3a40 R: 0000000000001f10 * + S: 0000000031cc3c20 R: 000000003006ecb0 .probe_phb4+0x54c + S: 0000000031cc3e30 R: 0000000030014ca4 .main_cpu_entry+0x5b0 + S: 0000000031cc3f00 R: 0000000030002700 boot_entry+0x1b8 + + This is caused as phb4_probe_stack() will ignore all xscom read/write + errors to enable PHB Bars and then tries to perform an mmio to read + PHB Version registers that cause the fatal MCE. + + We fix this by ignoring the PHB probe if the first xscom_write() to + populate the PHB Bar register fails, which indicates that there is + something wrong with the PHB. From patchwork Fri May 31 06:13:02 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108090 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZDZ66ZXz9s00 for ; Fri, 31 May 2019 16:24:46 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZDZ56SHzDqcl for ; Fri, 31 May 2019 16:24:46 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0L4jgpzDqYP for ; Fri, 31 May 2019 16:14:10 +1000 (AEST) Received: from pps.filterd (m0098417.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V668Bu145223 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e31.co.us.ibm.com (e31.co.us.ibm.com [32.97.110.149]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvp63v0u-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e31.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:06 +0100 Received: from b03cxnp07029.gho.boulder.ibm.com (9.17.130.16) by e31.co.us.ibm.com (192.168.1.131) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp07029.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4Wm7340424 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 662C0C6055 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 2E7B3C605B for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 806EC507BD6; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:02 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-8235-0000-0000-00000EA0F3AA X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-8236-0000-0000-000045C9C0ED Message-Id: <20190531061351.22973-62-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=13 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=871 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 061/110] doc: Add missing skiboot 5.9.8 release notes X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/release-notes/skiboot-5.9.8.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 doc/release-notes/skiboot-5.9.8.rst diff --git a/doc/release-notes/skiboot-5.9.8.rst b/doc/release-notes/skiboot-5.9.8.rst new file mode 100644 index 000000000000..d8bc966f90dd --- /dev/null +++ b/doc/release-notes/skiboot-5.9.8.rst @@ -0,0 +1,16 @@ +.. _skiboot-5.9.8: + +============= +skiboot-5.9.8 +============= + +skiboot-5.9.8 was released on Friday January 5th, 2018. It replaces +:ref:`skiboot-5.9.7` as the current stable release in the 5.9.x series. + +Over :ref:`skiboot-5.9.7`, we have one new feature: + +- Parse IPL FW feature settings + + Add parsing for the firmware feature flags in the HDAT. This + indicates the settings of various parameters which are set at IPL time + by firmware. From patchwork Fri May 31 06:13:03 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108129 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZQ73T9gz9s00 for ; Fri, 31 May 2019 16:33:03 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZQ64TGlzDqgn for ; Fri, 31 May 2019 16:33:02 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N6MLyzDqYP for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098419.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V65Rrk135927 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e35.co.us.ibm.com (e35.co.us.ibm.com [32.97.110.153]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stv224n5k-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e35.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b03cxnp07029.gho.boulder.ibm.com (9.17.130.16) by e35.co.us.ibm.com (192.168.1.135) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b03ledav001.gho.boulder.ibm.com (b03ledav001.gho.boulder.ibm.com [9.17.130.232]) by b03cxnp07029.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4Iu7340428 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 93B206E050 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 315196E04E for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav001.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 84E73507BD8; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:03 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0012-0000-0000-0000173DDCFD X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:07 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0013-0000-0000-00005778F809 Message-Id: <20190531061351.22973-63-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=13 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=979 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 062/110] doc: Add missing skiboot-4.0 release notes X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/index.rst | 9 +++++---- doc/release-notes/skiboot-4.0.rst | 16 ++++++++++++++++ 2 files changed, 21 insertions(+), 4 deletions(-) create mode 100644 doc/release-notes/skiboot-4.0.rst diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 98fedee9f723..3816113b788b 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -225,15 +225,16 @@ The OPAL API is the interface between an Operating System and OPAL. | :ref:`OPAL_GET_DPO_STATUS` | 105 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_OLD_I2C_REQUEST` | 106 | Introduced and | | Do not use. | -| | | deprecated in v4.0. | | | +| | | deprecated in | | | +| | | :ref:`skiboot-4.0`. | | | | | | Should be completely | | | | | | unused. | | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_IPMI_SEND` | 107 | v4.0 | POWER9 | | +| :ref:`OPAL_IPMI_SEND` | 107 | :ref:`skiboot-4.0` | POWER9 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_IPMI_RECV` | 108 | v4.0 | POWER9 | | +| :ref:`OPAL_IPMI_RECV` | 108 | :ref:`skiboot-4.0` | POWER9 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_I2C_REQUEST` | 109 | v4.0 | POWER9 | | +| :ref:`OPAL_I2C_REQUEST` | 109 | :ref:`skiboot-4.0` | POWER9 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_FLASH_READ` | 110 | v5.0 | POWER9 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ diff --git a/doc/release-notes/skiboot-4.0.rst b/doc/release-notes/skiboot-4.0.rst new file mode 100644 index 000000000000..5853f0f0f2b7 --- /dev/null +++ b/doc/release-notes/skiboot-4.0.rst @@ -0,0 +1,16 @@ +.. _skiboot-4.0: + +=========== +skiboot 4.0 +=========== + +Skiboot 4.0 was released 19th November 2014. It was the first release to obtain +an independent version number and numbering scheme. Previous releases were +identified either purely by a GIT SHA1 hash or the associated PowerKVM release +number. + +This release introduced the following OPAL calls: + + - :ref:`OPAL_IPMI_SEND` + - :ref:`OPAL_IPMI_RECV` + - :ref:`OPAL_I2C_REQUEST` From patchwork Fri May 31 06:13:04 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108111 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZKy38jQz9s00 for ; Fri, 31 May 2019 16:29:26 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZKy21FKzDqK6 for ; Fri, 31 May 2019 16:29:26 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N3Ky3zDqYd for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098421.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V674wW066702 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e33.co.us.ibm.com (e33.co.us.ibm.com [32.97.110.151]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stxqh8779-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:08 -0400 Received: from localhost by e33.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b03cxnp07029.gho.boulder.ibm.com (9.17.130.16) by e33.co.us.ibm.com (192.168.1.133) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp07029.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4B430408728 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 97E9AC605F for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 3540EC605D for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 89615507BD9; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:04 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0036-0000-0000-00000AC51852 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0037-0000-0000-00004C02147D Message-Id: <20190531061351.22973-64-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=13 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 063/110] doc: Add missing skiboot-5.0 release notes X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/index.rst | 12 +-- doc/release-notes/skiboot-5.0.rst | 145 ++++++++++++++++++++++++++++++ 2 files changed, 151 insertions(+), 6 deletions(-) create mode 100644 doc/release-notes/skiboot-5.0.rst diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 3816113b788b..45280512b1ef 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -236,17 +236,17 @@ The OPAL API is the interface between an Operating System and OPAL. +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_I2C_REQUEST` | 109 | :ref:`skiboot-4.0` | POWER9 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_FLASH_READ` | 110 | v5.0 | POWER9 | | +| :ref:`OPAL_FLASH_READ` | 110 | :ref:`skiboot-5.0` | POWER9 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_FLASH_WRITE` | 111 | v5.0 | POWER9 | | +| :ref:`OPAL_FLASH_WRITE` | 111 | :ref:`skiboot-5.0` | POWER9 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_FLASH_ERASE` | 112 | v5.0 | POWER9 | | +| :ref:`OPAL_FLASH_ERASE` | 112 | :ref:`skiboot-5.0` | POWER9 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_PRD_MSG` | 113 | v5.0 | POWER9 | | +| :ref:`OPAL_PRD_MSG` | 113 | :ref:`skiboot-5.0` | POWER9 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_LEDS_GET_INDICATOR` | 114 | v5.0 | POWER9 | | +| :ref:`OPAL_LEDS_GET_INDICATOR` | 114 | :ref:`skiboot-5.0` | POWER9 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_LEDS_SET_INDICATOR` | 115 | v5.0 | POWER9 | | +| :ref:`OPAL_LEDS_SET_INDICATOR` | 115 | :ref:`skiboot-5.0` | POWER9 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_CEC_REBOOT2` | 116 | :ref:`skiboot-5.1.0` | POWER9 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ diff --git a/doc/release-notes/skiboot-5.0.rst b/doc/release-notes/skiboot-5.0.rst new file mode 100644 index 000000000000..0a62546ef359 --- /dev/null +++ b/doc/release-notes/skiboot-5.0.rst @@ -0,0 +1,145 @@ +.. _skiboot-5.0: + +=========== +skiboot 5.0 +=========== + +Skiboot 5.0 was released Friday 10th April 2015. + +Changes in 5.0 (since rc3): + + - Fix chip id for nx coprocessors. + - hw/ipmi: Fix FW Boot Progress sensor + - bt: Add a temporary workaround for bmc dropping messages + - FSP/CUPD: Fix lock issue + +Changes in rc3 (since rc2): + + - add support for cec_power_down on mambo + - external/opal-prd: Use link register for cross-endian branch + - opal header file rework, Linux and skiboot now very closely match (API + in opal-api.h) + - libflash: don't use the low level interface if it doesn't exist + - libflash/file: add file abstraction for libflash + - external: create a GUARD partition parsing utility + +Changes in rc2 (since rc1): + + - opal: Fix an issue where partial LID load causes opal to hang. + - nx: use proc_gen instead of param + - use chip id for NX engine Coproc Instance num + - Fix (hopefully) missing dot symbols in skiboot.map + - exceptions: Catch exceptions at boot time + - exceptions: Remove deprecated exception patching stuff + - mambo: Make mambo_utils.tcl optional + - mambo: Exit mambo when the simulation is stopped + - add NX register defines + - set NX crb input queues to 842 only + - core: Catch attempts to branch through a NULL pointer + - plat/firestone: Add missing platform hooks + - plat/firestone: Add missing platform hooks + - elog: Don't call uninitialized platform elog_commit + - external/opal-prd: Use "official" switch-endian syscall + - hw/ipmi: Rework sensors and fix boot count sensor + +Changes in rc1 (since 4.1.1): + +General: + + * big OPAL API documentation updates + We now document around 19 OPAL calls. There's still ~100 left to doc + though :) + * skiboot can load FreeBSD kernel payload (thanks to Nathan Whitehorn) + * You can now run sparse by setting C=1 when building + * PSI: Revert the timeout for PSI link recovery to architected value + now 30mins (prev 15) + * cpuidle: Add validated metrics for idle states + * core/flash: Add flash API + OPAL_FLASH_(READ|WRITE|ERASE) + * capi: Dynamically calculate which CAPP port to use + no longer hardwired to PHB0 + * vpd: Use slca parent-child relationship to create vpd tree + * opal: Do not overwrite same HMI event for multiple HMI errors. + Now Linux will get a HMI event for each HMI error + * HMI event v2 now includes information about checkstop + * HMI improvements, handle more conditions gracefully: + + * TB residue error + * TFMR firmware control error + * TFMR parity + * TFMR HDEC parity error + * TFMR DEC parity error + * TFMR SPURR/PURR parity error + * TB residue and HDEC parity HMI errors on split core + * hostservices: Cache lids prior to first load request + * Warn when pollers are called with a lock held + and keep track of lock depth. + + **NOTE:** This means we will get backtraces in skiboot msglog on FSP machines + This is a KNOWN ISSUE and is largely harmless. + There's still a couple that we haven't yet cleaned, these + messages can be thought of as a TODO list for developers. + + * Don't run pollers in time_wait if lock held + * pci: Don't hang if we have only one CPU + * Detect recursive poller entry + * General cleanup + * Cleanup of opal.h so that we can have Linux and skiboot match + * add sparse annotations to opal.h + * Platform hooks for loading and preloading resources (LIDs) + This lays the groundwork for cutting 4-20 seconds off boot in a + future skiboot release. + * Fix potential race when clearing OCC interrupt status + * Add platform operation for reading sensors + + * add support to read core and memory buffer temperatures + +Mambo/POWER8 Functional Simulator: + + * Replace is_mambo_chip() with a better quirks mechanism. + * Don't hang if we only have one CPU and PCI. + +BMC systems: + + * BMC can load payload from flash + * IPMI on BMC systems: graceful poweroff and reboot + * IPMI on BMC systems: watchdog timer support + * IPMI on BMC systems: PNOR locking + * Support for IPMI progress sensor + * IPMI boot count sensor + * capi: Rework microcode flash download and CAPP upload + load microcode on non-fsp systems + * NEW opal-prd userspace tool that handles PRD on non-FSP systems. + and OPAL PRD calls to support it. + * Improvements to opal-prd, libflash, and ipmi + * ECC support in libflash + * Load CAPI micro code, enabling CAPI on OpenPower systems. + * Dynamically calculate which CAPP port to use, don't hardcode to PHB0 + * memboot flash backend + +POWER8 + + * add nx-842 coproc support + +FSP systems: + + * Make abort() update sp attn area (like assert does) + On FSP systems this gives better error logs/dumps when abort() is hit + * FSP/LEDS: Many improvements and bug fixes + * LED support for FSP machines + Adds OPAL_LEDS_(GET|SET)_INDICATOR and device-tree bindings + * Refactor of fsp-rtc + * OCC loading fixes, including possible race condition where we would + fail to IPL. + +POWER7 + + * Fix unsupported return code of OPAL_(UN)REGISTER_DUMP_REGION on P7 + * occ: Don't do bad XSCOMs on P7 + The OCC interrupt register only exists on P8, accessing it on P7 causes + not only error logs but also causes PRD to eventually gard chips. + * cpu: Handle opal_reinit_cpus() more gracefully on P7 + no longer generate error logs + * libflash updates for openpower + * misc code cleanup + * add nx-842 coproc support From patchwork Fri May 31 06:13:05 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108089 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZDM1bBzz9s00 for ; Fri, 31 May 2019 16:24:35 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZDM0Gs9zDqdP for ; Fri, 31 May 2019 16:24:35 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0L2dcmzDqXv for ; Fri, 31 May 2019 16:14:10 +1000 (AEST) Received: from pps.filterd (m0098404.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64FGJ042323 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from e12.ny.us.ibm.com (e12.ny.us.ibm.com [129.33.205.202]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4vhd66-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e12.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:06 +0100 Received: from b01cxnp23032.gho.pok.ibm.com (9.57.198.27) by e12.ny.us.ibm.com (146.89.104.199) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:05 +0100 Received: from b01ledav004.gho.pok.ibm.com (b01ledav004.gho.pok.ibm.com [9.57.199.109]) by b01cxnp23032.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E4L737880232 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:04 GMT Received: from b01ledav004.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 920B6112065 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b01ledav004.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 4DC48112061 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav004.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 8DC30507BDE; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:05 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0060-0000-0000-0000034A56E2 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0061-0000-0000-0000498FD376 Message-Id: <20190531061351.22973-65-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=13 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 064/110] doc: Add missing skiboot-4.1 release notes X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/release-notes/skiboot-4.1.rst | 43 +++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 doc/release-notes/skiboot-4.1.rst diff --git a/doc/release-notes/skiboot-4.1.rst b/doc/release-notes/skiboot-4.1.rst new file mode 100644 index 000000000000..341c10f5524a --- /dev/null +++ b/doc/release-notes/skiboot-4.1.rst @@ -0,0 +1,43 @@ +.. _skiboot-4.1: + +=========== +skiboot 4.1 +=========== + +Skiboot 4.1 was released 10th December 2014. It was a release where more +development transitioned to the open source mailing list rather than internal +mailing lists. + +Changes include: + + - We now build with -fstack-protector and -Werror + - Stack checking extensions when built with STACK_CHECK=1 + - Reduced stack usage in some areas, -Wstack-usage=1024 now. + + - Some functions could use 2kb stack, now all are <1kb + - Unsafe libc functions such as sprintf() have been removed + - Symbolic backtraces + - expose skiboot symbol map to OS (via device-tree) + - removed machine check interrupt patching in OPAL + - occ/hbrt: Call stopOCC() for implementing reset OCC command from FSP + - occ: Fix the low level ACK message sent to FSP on receiving {RESET/LOAD}_OCC + - hardening to errors of various FSP code + + - fsp: Avoid NULL dereference in case of invalid class_resp bits- + abort if device tree parsing fails + - FSP: Validate fsp_msg in fsp_queue_msg + - fsp-elog: Add various NULL checks + - Finessing of when to use error log vs prerror() + - More i2c work + - Can now run under Mambo simulator (see external/mambo/skiboot.tcl) + (commonly known as "POWER8 Functional Simulator") + - Document skiboot versioning scheme + - opal: Handle more TFAC errors. + + - TB_RESIDUE_ERR, FW_CONTROL_ERR and CHIP_TOD_PARITY_ERR + - ipmi: populate FRU data + - rtc: Add a generic rtc cache + - ipmi/rtc: use generic cache + - Error Logging backend for bmc based machines + - PSI: Drive link down on HIR + - occ: Fix clearing of OCC interrupt on remote fix From patchwork Fri May 31 06:13:06 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108112 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZLK3vkDz9s00 for ; Fri, 31 May 2019 16:29:45 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZLK2wNnzDqcw for ; Fri, 31 May 2019 16:29:45 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N38qbzDqYB for ; Fri, 31 May 2019 16:14:11 +1000 (AEST) Received: from pps.filterd (m0098421.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V674kV066727 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e32.co.us.ibm.com (e32.co.us.ibm.com [32.97.110.150]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stxqh876u-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from localhost by e32.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b03cxnp08028.gho.boulder.ibm.com (9.17.130.20) by e32.co.us.ibm.com (192.168.1.132) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp08028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E58H32702810 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id DEB4B6A067 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id A756D6A04F for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 924FE507BE0; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:06 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0004-0000-0000-0000151674FB X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:06 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0005-0000-0000-00008BDE97A6 Message-Id: <20190531061351.22973-66-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=13 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 065/110] doc: Add missing skiboot-4.1.1 release notes X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/release-notes/skiboot-4.1.1.rst | 40 +++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 doc/release-notes/skiboot-4.1.1.rst diff --git a/doc/release-notes/skiboot-4.1.1.rst b/doc/release-notes/skiboot-4.1.1.rst new file mode 100644 index 000000000000..a2aa8657a17b --- /dev/null +++ b/doc/release-notes/skiboot-4.1.1.rst @@ -0,0 +1,40 @@ +.. _skiboot-4.1.1: + +============= +skiboot 4.1.1 +============= + +Skiboot 4.1 was released 30th January 2015. + + * fsp: Avoid NULL dereference in case of invalid class_resp bits + CQ: SW288484 + * Makefile: Support CROSS_COMPILE as well as CROSS + * Additional unit testing: + + * Tiny hello_world kernel + * Will run boot tests with hello_world and (if present) petitboot + image in the POWER8 Functional simulator (mambo) (if present) + * Run CCAN unit tests as part of 'make check' + * Increased testing of PEL code + * unit test console-log + * skeleton libc unit tests + * Fix compatible match for palmetto & habanero + The strings should be "tyan,..." not "ibm,..." + (N/A for IBM systems) + * i2c: Unify the frequencies to calculate bit rate divisor + * Unlock rtc cache lock when cache isn't valid + Could cause IPL crash on POWER7 + * Initial documentation for OPAL API, ABI and Specification + * Add Firestone platform + * Fix crash when one socket wasn't populated with a CPU + LTC-Bugzilla: 120562 + * Bug fix in RTC state machine which possibly led to RTC not working + * Makefile fixes for running with some GCC 4.9 compilers + * Add device tree properties for pstate vdd and vcs values + * cpuidle: Add validated metrics for idle states + Export residency times in device tree + * Revert "platforms/astbmc: Temporary reboot workaround" + (N/A for IBM systems) + * Fix buffer overrun in print_* functions. + This could cause IPL failures or conceivably other runtime problems + From patchwork Fri May 31 06:13:07 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108095 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZFz3D5yz9s00 for ; Fri, 31 May 2019 16:25:59 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZFz2M7DzDqY0 for ; Fri, 31 May 2019 16:25:59 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0L4RWBzDqYk for ; Fri, 31 May 2019 16:14:10 +1000 (AEST) Received: from pps.filterd (m0098410.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64Cf4141597 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4vsa9u-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dmxR006006 for ; Fri, 31 May 2019 02:48:58 GMT Received: from b03cxnp07028.gho.boulder.ibm.com (b03cxnp07028.gho.boulder.ibm.com [9.17.130.15]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9aykh-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:58 +0000 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp07028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5ZO459092 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id F1E606A058 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id BA7F36A05D for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 971E4507BE2; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:07 +1000 Message-Id: <20190531061351.22973-67-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 066/110] doc: Add skeleton OPAL_PCI_EEH_FREEZE_STATUS docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Fixes: https://github.com/open-power/skiboot/issues/99 Signed-off-by: Stewart Smith --- .../opal-pci-eeh-freeze-status-23.rst | 50 +++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 doc/opal-api/opal-pci-eeh-freeze-status-23.rst diff --git a/doc/opal-api/opal-pci-eeh-freeze-status-23.rst b/doc/opal-api/opal-pci-eeh-freeze-status-23.rst new file mode 100644 index 000000000000..035dc14e35b6 --- /dev/null +++ b/doc/opal-api/opal-pci-eeh-freeze-status-23.rst @@ -0,0 +1,50 @@ +.. _OPAL_PCI_EEH_FREEZE_STATUS: + +OPAL_PCI_EEH_FREEZE_STATUS +========================== + +.. code-block:: c + + #define OPAL_PCI_EEH_FREEZE_STATUS 23 + + enum OpalFreezeState { + OPAL_EEH_STOPPED_NOT_FROZEN = 0, + OPAL_EEH_STOPPED_MMIO_FREEZE = 1, + OPAL_EEH_STOPPED_DMA_FREEZE = 2, + OPAL_EEH_STOPPED_MMIO_DMA_FREEZE = 3, + OPAL_EEH_STOPPED_RESET = 4, + OPAL_EEH_STOPPED_TEMP_UNAVAIL = 5, + OPAL_EEH_STOPPED_PERM_UNAVAIL = 6 + }; + + enum OpalPciStatusToken { + OPAL_EEH_NO_ERROR = 0, + OPAL_EEH_IOC_ERROR = 1, + OPAL_EEH_PHB_ERROR = 2, + OPAL_EEH_PE_ERROR = 3, + OPAL_EEH_PE_MMIO_ERROR = 4, + OPAL_EEH_PE_DMA_ERROR = 5 + }; + + int64_t opal_pci_eeh_freeze_status(uint64_t phb_id, uint64_t pe_number, + uint8_t *freeze_state, + uint16_t *pci_error_type, + uint64_t *phb_status); + +.. note:: The ``phb_status`` parameter is deprecated as + of :ref:`skiboot-6.3-rc1`. Linux only ever passed in NULL, + and this was safe. Supplying a pointer was previously *unsafe*. + Always pass NULL. + + +Returns +------- + +:ref:`OPAL_PARAMETER` + Invalid address or PHB. +:ref:`OPAL_UNSUPPORTED` + PHB does not support this operation. +:ref:`OPAL_HARDWARE` + Hardware prohibited getting status, OPAL maybe marked it as broken. +:ref:`OPAL_SUCCESS` + Retreived status. From patchwork Fri May 31 06:13:08 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108128 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZPq3RYrz9sN6 for ; Fri, 31 May 2019 16:32:47 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZPq2WKWzDqRf for ; Fri, 31 May 2019 16:32:47 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N5kX4zDqZF for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098416.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V643Qg019012 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e16.ny.us.ibm.com (e16.ny.us.ibm.com [129.33.205.206]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stty1pnfx-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:08 -0400 Received: from localhost by e16.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b01cxnp23032.gho.pok.ibm.com (9.57.198.27) by e16.ny.us.ibm.com (146.89.104.203) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b01ledav001.gho.pok.ibm.com (b01ledav001.gho.pok.ibm.com [9.57.199.106]) by b01cxnp23032.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5CF35914078 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 1CFD728059 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id CE27628058 for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav001.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 9CC10507BE5; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:08 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0072-0000-0000-00000435AFC3 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:07 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0073-0000-0000-00004C6D3D07 Message-Id: <20190531061351.22973-68-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=659 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 067/110] doc: OPAL_PCI_SHPC was never implemented X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/index.rst | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 45280512b1ef..0da4b643371c 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -65,7 +65,8 @@ The OPAL API is the interface between an Operating System and OPAL. +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_EEH_FREEZE_STATUS` | 23 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_PCI_SHPC` | 24 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_PCI_SHPC` | 24 | Never | POWER8 | Never | +| | | | | Implemented | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_CONSOLE_WRITE_BUFFER_SPACE` | 25 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -383,6 +384,8 @@ removed and no longer supported. +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_GET_COMPLETION_TOKEN_STATUS` | 21 | Never | | +---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_PCI_SHPC` | 24 | Never | | ++---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_WRITE_OPPANEL` | 43 | pre-v1.0 | pre-v1.0 | +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_OLD_I2C_REQUEST` | 106 | v4.0 | v4.0 | @@ -405,6 +408,14 @@ had a call called this. This call has never been implemented, and never will be. +.. _OPAL_PCI_SHPC: + +OPAL_PCI_SHPC +^^^^^^^^^^^^^ + +A remnant of a long forgotten incarnation of OPAL. Never implemented, never +will be. + .. _OPAL_WRITE_OPPANEL: OPAL_WRITE_OPPANEL From patchwork Fri May 31 06:13:09 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108117 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZMc5PnTz9s00 for ; Fri, 31 May 2019 16:30:52 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZMc4RlrzDqfF for ; Fri, 31 May 2019 16:30:52 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N4njYzDqYS for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098413.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V68YoP037780 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e14.ny.us.ibm.com (e14.ny.us.ibm.com [129.33.205.204]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxr105pd-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:08 -0400 Received: from localhost by e14.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b01cxnp23032.gho.pok.ibm.com (9.57.198.27) by e14.ny.us.ibm.com (146.89.104.201) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b01ledav001.gho.pok.ibm.com (b01ledav001.gho.pok.ibm.com [9.57.199.106]) by b01cxnp23032.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E51H37880238 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 2C9F828060 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id DE24E2805E for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav001.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id A116D507BE6; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:09 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0052-0000-0000-000003C9773B X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:07 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0053-0000-0000-0000611BF5E7 Message-Id: <20190531061351.22973-69-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=654 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 068/110] doc: Add skeleton OPAL_PCI_EEH_FREEZE_CLEAR docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Fixes: https://github.com/open-power/skiboot/issues/101 Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-eeh-freeze-clear-26.rst | 33 +++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 doc/opal-api/opal-pci-eeh-freeze-clear-26.rst diff --git a/doc/opal-api/opal-pci-eeh-freeze-clear-26.rst b/doc/opal-api/opal-pci-eeh-freeze-clear-26.rst new file mode 100644 index 000000000000..af796f0f376b --- /dev/null +++ b/doc/opal-api/opal-pci-eeh-freeze-clear-26.rst @@ -0,0 +1,33 @@ +.. _OPAL_PCI_EEH_FREEZE_CLEAR: + +OPAL_PCI_EEH_FREEZE_CLEAR +========================= + +.. code-block:: c + + #define OPAL_PCI_EEH_FREEZE_CLEAR 26 + + enum OpalEehFreezeActionToken { + OPAL_EEH_ACTION_CLEAR_FREEZE_MMIO = 1, + OPAL_EEH_ACTION_CLEAR_FREEZE_DMA = 2, + OPAL_EEH_ACTION_CLEAR_FREEZE_ALL = 3, + + OPAL_EEH_ACTION_SET_FREEZE_MMIO = 1, + OPAL_EEH_ACTION_SET_FREEZE_DMA = 2, + OPAL_EEH_ACTION_SET_FREEZE_ALL = 3 + }; + + int64_t opal_pci_eeh_freeze_clear(uint64_t phb_id, uint64_t pe_number, uint64_t eeh_action_token); + + +Returns +------- +:ref:`OPAL_SUCCESS` + Success! +:ref:`OPAL_PARAMETER` + Invalid PHB +:ref:`OPAL_UNSUPPORTED` + PHB doesn't support this operation. +:ref:`OPAL_HARDWARE` + Hardware issue prevents completing operation. OPAL may have detected it + being broken. From patchwork Fri May 31 06:13:10 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108173 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZb852MGz9s00 for ; Fri, 31 May 2019 16:40:52 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZb83vsBzDqtn for ; Fri, 31 May 2019 16:40:52 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ1p144XzDqY6 for ; Fri, 31 May 2019 16:15:25 +1000 (AEST) Received: from pps.filterd (m0098393.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64BXC075973 for ; Fri, 31 May 2019 02:15:23 -0400 Received: from e17.ny.us.ibm.com (e17.ny.us.ibm.com [129.33.205.207]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvha4bhg-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:15:23 -0400 Received: from localhost by e17.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:15:22 +0100 Received: from b01cxnp23033.gho.pok.ibm.com (9.57.198.28) by e17.ny.us.ibm.com (146.89.104.204) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:15:21 +0100 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp23033.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5D440960256 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 6A864B2067 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id E4604B205F for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:04 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id A6C39507BE8; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:10 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0040-0000-0000-000004F6E3EE X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992125; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:15:22 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0041-0000-0000-00000902FEBD Message-Id: <20190531061351.22973-70-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 069/110] Remove unused OPAL_PCI_EEH_FREEZE_STATUS2 X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" This call was introduced all the way back at the end of 2012, before OPAL was public. The #define for the OPAL call was introduced to the Linux kernel in June 2013, and the call was never used in any kernel tree ever (as far as we can find). Thus, it's quite safe to remove this completely unused and completely untested OPAL call. Fixes: https://github.com/open-power/skiboot/issues/99 Signed-off-by: Stewart Smith --- core/pci-opal.c | 31 ------------------- doc/opal-api/index.rst | 5 ++- .../opal-pci-eeh-freeze-status-23.rst | 21 +++++++++++++ 3 files changed, 25 insertions(+), 32 deletions(-) diff --git a/core/pci-opal.c b/core/pci-opal.c index 08883949e629..b0e61b639f39 100644 --- a/core/pci-opal.c +++ b/core/pci-opal.c @@ -929,37 +929,6 @@ static int64_t opal_pci_next_error(uint64_t phb_id, uint64_t *first_frozen_pe, } opal_call(OPAL_PCI_NEXT_ERROR, opal_pci_next_error, 4); -static int64_t opal_pci_eeh_freeze_status2(uint64_t phb_id, uint64_t pe_number, - uint8_t *freeze_state, - uint16_t *pci_error_type, - uint16_t *severity, - uint64_t *phb_status) -{ - struct phb *phb = pci_get_phb(phb_id); - int64_t rc; - - if (!opal_addr_valid(freeze_state) || !opal_addr_valid(pci_error_type) - || !opal_addr_valid(severity) || !opal_addr_valid(phb_status)) - return OPAL_PARAMETER; - - if (!phb) - return OPAL_PARAMETER; - if (!phb->ops->eeh_freeze_status) - return OPAL_UNSUPPORTED; - phb_lock(phb); - - if (phb_status) - prlog(PR_ERR, "PHB#%04llx: %s: deprecated PHB status\n", - phb_id, __func__); - - rc = phb->ops->eeh_freeze_status(phb, pe_number, freeze_state, - pci_error_type, severity); - phb_unlock(phb); - - return rc; -} -opal_call(OPAL_PCI_EEH_FREEZE_STATUS2, opal_pci_eeh_freeze_status2, 6); - static int64_t opal_pci_set_phb_capi_mode(uint64_t phb_id, uint64_t mode, uint64_t pe_number) { struct phb *phb = pci_get_phb(phb_id); diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 0da4b643371c..aa775b5fe712 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -134,7 +134,8 @@ The OPAL API is the interface between an Operating System and OPAL. +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_NEXT_ERROR` | 60 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_PCI_EEH_FREEZE_STATUS2` | 61 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_PCI_EEH_FREEZE_STATUS2` | 61 | v1.0 (Initial Release) | POWER8 | Removed, never | +| | | | | used! | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_POLL` | 62 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -396,6 +397,8 @@ removed and no longer supported. +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_SET_PHB_TCE_MEMORY` | 12 | pre-v1.0 | :ref:`skiboot-5.2.0` | +---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_PCI_EEH_FREEZE_STATUS2` | 61 | v1.0 Initial Release | :ref:`skiboot-6.4` | ++---------------------------------------------+-------+-----------------------+-----------------------+ .. _OPAL_GET_COMPLETION_TOKEN_STATUS: diff --git a/doc/opal-api/opal-pci-eeh-freeze-status-23.rst b/doc/opal-api/opal-pci-eeh-freeze-status-23.rst index 035dc14e35b6..94b7245b47a9 100644 --- a/doc/opal-api/opal-pci-eeh-freeze-status-23.rst +++ b/doc/opal-api/opal-pci-eeh-freeze-status-23.rst @@ -36,6 +36,9 @@ OPAL_PCI_EEH_FREEZE_STATUS and this was safe. Supplying a pointer was previously *unsafe*. Always pass NULL. +.. note:: There once was a :ref:`OPAL_PCI_EEH_FREEZE_STATUS2` call, but it + was introduced in firmware and never used by any OS, so it has since + been removed from OPAL. Returns ------- @@ -48,3 +51,21 @@ Returns Hardware prohibited getting status, OPAL maybe marked it as broken. :ref:`OPAL_SUCCESS` Retreived status. + +.. _OPAL_PCI_EEH_FREEZE_STATUS2: + +OPAL_PCI_EEH_FREEZE_STATUS2 +=========================== + +.. code-block:: c + + #define OPAL_PCI_EEH_FREEZE_STATUS2 61 + +Use :ref:`OPAL_PCI_EEH_FREEZE_STATUS` instead of this (removed) call. + +While you'd think that a call introduced in the first public OPAL release would +have been used somewhere, it seems that all existing code has only ever used +:ref:`OPAL_PCI_EEH_FREEZE_STATUS` over :ref:`OPAL_PCI_EEH_FREEZE_STATUS2`. + +This call has been removed as of :ref:`skiboot-6.4` as it has literally never +been used. From patchwork Fri May 31 06:13:11 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108115 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZM541B9z9s00 for ; Fri, 31 May 2019 16:30:25 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZM52Mx7zDqbk for ; Fri, 31 May 2019 16:30:25 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N4ng8zDqWJ for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098409.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64242059970 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4v99xe-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dbKk005901 for ; Fri, 31 May 2019 02:48:57 GMT Received: from b01cxnp23033.gho.pok.ibm.com (b01cxnp23033.gho.pok.ibm.com [9.57.198.28]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9aykj-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:57 +0000 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp23033.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5As37814534 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 59395B2068 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 1673AB2067 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id AC069507BEC; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:11 +1000 Message-Id: <20190531061351.22973-71-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=725 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 070/110] doc: prettify OPAL_PCI_PHB_MMIO_ENABLE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-phb-mmio-enable-27.rst | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/doc/opal-api/opal-pci-phb-mmio-enable-27.rst b/doc/opal-api/opal-pci-phb-mmio-enable-27.rst index 62b4ea3b1b8e..e3ca02f57773 100644 --- a/doc/opal-api/opal-pci-phb-mmio-enable-27.rst +++ b/doc/opal-api/opal-pci-phb-mmio-enable-27.rst @@ -1,11 +1,16 @@ +.. _OPAL_PCI_PHB_MMIO_ENABLE: + OPAL_PCI_PHB_MMIO_ENABLE ======================== -:: + +.. code-block:: c #define OPAL_PCI_PHB_MMIO_ENABLE 27 - static int64_t opal_pci_phb_mmio_enable(uint64_t phb_id, uint16_t window_type, - uint16_t window_num, uint16_t enable) + int64_t opal_pci_phb_mmio_enable(uint64_t phb_id, uint16_t window_type, + uint16_t window_num, uint16_t enable); + +.. note:: Appears to be POWER7 p7ioc specific. Likely to be removed soon. **WARNING:** following documentation is from old sources, and is possibly not representative of OPALv3 as implemented by skiboot. This should be @@ -20,14 +25,14 @@ PHB decode and forwarding for the address range defined in a particular MMIO window. Not all PHB hardware may support disabling some or all MMIO windows. OPAL -returns OPAL_UNSUPPORTED if called to disable an MMIO window for which +returns :ref:`OPAL_UNSUPPORTED` if called to disable an MMIO window for which hardware does not support disable. KVM may call this function for all MMIO windows and ignore the opal_unsuppsorted return code so long as KVM has disabled MMIO to all downstream PCI devices and assured that KVM and OS guest partitions cannot issue CI loads/stores to these address spaces from the processor (e.g.,via HPT). -OPAL returns OPAL_SUCCESS for calls to OPAL to enable them for PHBs that do +OPAL returns :ref:`OPAL_SUCCESS` for calls to OPAL to enable them for PHBs that do not support disable. ``phb_id`` From patchwork Fri May 31 06:13:12 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108099 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZGy4RNgz9s00 for ; Fri, 31 May 2019 16:26:50 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZGy3fBRzDqYh for ; Fri, 31 May 2019 16:26:50 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0M4yHjzDqXt for ; Fri, 31 May 2019 16:14:11 +1000 (AEST) Received: from pps.filterd (m0098420.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V6Auaq086659 for ; Fri, 31 May 2019 02:14:07 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxsbg1tj-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:07 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dbKl005901 for ; Fri, 31 May 2019 02:48:58 GMT Received: from b03cxnp08028.gho.boulder.ibm.com (b03cxnp08028.gho.boulder.ibm.com [9.17.130.20]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9aykk-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:58 +0000 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp08028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5Po32702812 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 47A43BE054 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 0F6F9BE051 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id B048E507BED; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:12 +1000 Message-Id: <20190531061351.22973-72-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 071/110] doc: prettify OPAL_PCI_SET_PHB_MEM_WINDOW X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- .../opal-pci-set-phb-mem-window-28.rst | 23 ++++++++++++------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/doc/opal-api/opal-pci-set-phb-mem-window-28.rst b/doc/opal-api/opal-pci-set-phb-mem-window-28.rst index 0dc6b7036d5f..e23d841c1c9f 100644 --- a/doc/opal-api/opal-pci-set-phb-mem-window-28.rst +++ b/doc/opal-api/opal-pci-set-phb-mem-window-28.rst @@ -1,15 +1,20 @@ +.. _OPAL_PCI_SET_PHB_MEM_WINDOW: + OPAL_PCI_SET_PHB_MEM_WINDOW =========================== -:: + +.. code-block:: c #define OPAL_PCI_SET_PHB_MEM_WINDOW 28 - static int64_t opal_pci_set_phb_mem_window(uint64_t phb_id, - uint16_t window_type, - uint16_t window_num, - uint64_t addr, - uint64_t pci_addr, - uint64_t size) + int64_t opal_pci_set_phb_mem_window(uint64_t phb_id, + uint16_t window_type, + uint16_t window_num, + uint64_t addr, + uint64_t pci_addr, + uint64_t size); + +.. note:: Appears to be POWER7 p7ioc specific. Likely to be removed soon. **WARNING:** following documentation is from old sources, and is possibly not representative of OPALv3 as implemented by skiboot. This should be @@ -71,7 +76,9 @@ segment_size times the number of segments within this MMIO window. The host must set PHB memory windows to be within the system real address ranges indicated in the PHB parent HDT hub node ibm,opal-mmio-real property. -Return value: :: +Return value: + +.. code-block:: c if (!phb) return OPAL_PARAMETER; From patchwork Fri May 31 06:13:13 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108131 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZQY5Lztz9s00 for ; Fri, 31 May 2019 16:33:25 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZQY4RYjzDqgk for ; Fri, 31 May 2019 16:33:25 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N726WzDqZL for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098413.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V68Z9K037820 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e31.co.us.ibm.com (e31.co.us.ibm.com [32.97.110.149]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxr105pu-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e31.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b03cxnp08028.gho.boulder.ibm.com (9.17.130.20) by e31.co.us.ibm.com (192.168.1.131) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp08028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5U812190076 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 4ABA1BE04F for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 13C8DBE058 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id B4B64509F45; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:13 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-8235-0000-0000-00000EA0F3AC X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:07 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-8236-0000-0000-000045C9C0F1 Message-Id: <20190531061351.22973-73-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 072/110] doc: prettify OPAL_PCI_MAP_PE_MMIO_WINDOW X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- .../opal-pci-map-pe-mmio-window-29.rst | 21 ++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/doc/opal-api/opal-pci-map-pe-mmio-window-29.rst b/doc/opal-api/opal-pci-map-pe-mmio-window-29.rst index aaa1d9e98af2..a84da18ddc44 100644 --- a/doc/opal-api/opal-pci-map-pe-mmio-window-29.rst +++ b/doc/opal-api/opal-pci-map-pe-mmio-window-29.rst @@ -1,14 +1,19 @@ +.. _OPAL_PCI_MAP_PE_MMIO_WINDOW: + OPAL_PCI_MAP_PE_MMIO_WINDOW =========================== -:: + +.. code-block:: c #define OPAL_PCI_MAP_PE_MMIO_WINDOW 29 - static int64_t opal_pci_map_pe_mmio_window(uint64_t phb_id, - uint64_t pe_number, - uint16_t window_type, - uint16_t window_num, - uint16_t segment_num) + int64_t opal_pci_map_pe_mmio_window(uint64_t phb_id, + uint64_t pe_number, + uint16_t window_type, + uint16_t window_num, + uint16_t segment_num); + +.. note:: Appears to be POWER7 p7ioc specific. Likely to be removed soon. **WARNING:** following documentation is from old sources, and is possibly not representative of OPALv3 as implemented by skiboot. This should be @@ -38,7 +43,9 @@ The host calls this function to map a segment of MMIO address space to a PE. window. -Return value: :: +Return value: + +.. code-block:: c if (!phb) return OPAL_PARAMETER; From patchwork Fri May 31 06:13:14 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108110 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZKh5SZbz9s00 for ; Fri, 31 May 2019 16:29:12 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZKh4XW2zDqcJ for ; Fri, 31 May 2019 16:29:12 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N3xJczDqZ1 for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098404.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64IMR042660 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e36.co.us.ibm.com (e36.co.us.ibm.com [32.97.110.154]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4vhd6v-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:08 -0400 Received: from localhost by e36.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b03cxnp08028.gho.boulder.ibm.com (9.17.130.20) by e36.co.us.ibm.com (192.168.1.136) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp08028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E58m32702816 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 7184FBE04F for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 154D2BE059 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id B97FA50CBC0; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:14 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0020-0000-0000-00000EF2737F X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:07 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0021-0000-0000-000066081EDB Message-Id: <20190531061351.22973-74-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=793 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 073/110] Remove never implemented OPAL_PCI_SET_PHB_TABLE_MEMORY and document why X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Not ever used by upstream linux or PowerKVM tree. Never implemented in skiboot (not even in ancient internal only tree). So, it's incredibly safe to remove. Signed-off-by: Stewart Smith Reviewed-by: Andrew Donnellan --- core/pci-opal.c | 12 ------------ doc/opal-api/index.rst | 13 ++++++++++++- include/opal-api.h | 2 +- 3 files changed, 13 insertions(+), 14 deletions(-) diff --git a/core/pci-opal.c b/core/pci-opal.c index b0e61b639f39..9b8d4000490b 100644 --- a/core/pci-opal.c +++ b/core/pci-opal.c @@ -246,18 +246,6 @@ static int64_t opal_pci_map_pe_mmio_window(uint64_t phb_id, uint64_t pe_number, } opal_call(OPAL_PCI_MAP_PE_MMIO_WINDOW, opal_pci_map_pe_mmio_window, 5); -static int64_t opal_pci_set_phb_table_memory(uint64_t phb_id __unused, - uint64_t rtt_addr __unused, - uint64_t ivt_addr __unused, - uint64_t ivt_len __unused, - uint64_t rej_array_addr __unused, - uint64_t peltv_addr __unused) -{ - /* IODA2 (P8) stuff, TODO */ - return OPAL_UNSUPPORTED; -} -opal_call(OPAL_PCI_SET_PHB_TABLE_MEMORY, opal_pci_set_phb_table_memory, 6); - static int64_t opal_pci_set_pe(uint64_t phb_id, uint64_t pe_number, uint64_t bus_dev_func, uint8_t bus_compare, uint8_t dev_compare, uint8_t func_compare, diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index aa775b5fe712..6e7a8a16869f 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -78,7 +78,8 @@ The OPAL API is the interface between an Operating System and OPAL. +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_MAP_PE_MMIO_WINDOW` | 29 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_PCI_SET_PHB_TABLE_MEMORY` | 30 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_PCI_SET_PHB_TABLE_MEMORY` | 30 | Never | POWER8 | Never used or | +| | | | | Implemented | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_SET_PE` | 31 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -387,6 +388,8 @@ removed and no longer supported. +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_SHPC` | 24 | Never | | +---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_PCI_SET_PHB_TABLE_MEMORY` | 30 | Never | | ++---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_WRITE_OPPANEL` | 43 | pre-v1.0 | pre-v1.0 | +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_OLD_I2C_REQUEST` | 106 | v4.0 | v4.0 | @@ -419,6 +422,14 @@ OPAL_PCI_SHPC A remnant of a long forgotten incarnation of OPAL. Never implemented, never will be. +.. _OPAL_PCI_SET_PHB_TABLE_MEMORY: + +OPAL_PCI_SET_PHB_TABLE_MEMORY +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +A remnant of an old API design. Never implemented, never used. Only ever +returned :ref:`OPAL_UNSUPPORTED`, now the call is not implemented at all. + .. _OPAL_WRITE_OPPANEL: OPAL_WRITE_OPPANEL diff --git a/include/opal-api.h b/include/opal-api.h index 535cca88f5c2..f767d3c199a9 100644 --- a/include/opal-api.h +++ b/include/opal-api.h @@ -89,7 +89,7 @@ #define OPAL_PCI_PHB_MMIO_ENABLE 27 #define OPAL_PCI_SET_PHB_MEM_WINDOW 28 #define OPAL_PCI_MAP_PE_MMIO_WINDOW 29 -#define OPAL_PCI_SET_PHB_TABLE_MEMORY 30 +#define OPAL_PCI_SET_PHB_TABLE_MEMORY 30 /* never implemented */ #define OPAL_PCI_SET_PE 31 #define OPAL_PCI_SET_PELTV 32 #define OPAL_PCI_SET_MVE 33 From patchwork Fri May 31 06:13:15 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108136 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZRX0FhTz9s00 for ; Fri, 31 May 2019 16:34:16 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZRW64XczDqrV for ; Fri, 31 May 2019 16:34:15 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P43RYzDqYk for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098399.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64AXH136956 for ; Fri, 31 May 2019 02:14:10 -0400 Received: from e17.ny.us.ibm.com (e17.ny.us.ibm.com [129.33.205.207]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvyfukmy-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:10 -0400 Received: from localhost by e17.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b01cxnp23032.gho.pok.ibm.com (9.57.198.27) by e17.ny.us.ibm.com (146.89.104.204) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b01ledav002.gho.pok.ibm.com (b01ledav002.gho.pok.ibm.com [9.57.199.107]) by b01cxnp23032.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5gF39321918 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 7D7D312405B for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 370F0124055 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav002.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id BECA850CBC3; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:15 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0040-0000-0000-000004F6E3D3 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:07 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0041-0000-0000-00000902FEA2 Message-Id: <20190531061351.22973-75-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 074/110] doc: prettify OPAL_PCI_SET_PE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-set-pe-31.rst | 36 +++++++++++++++-------------- 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/doc/opal-api/opal-pci-set-pe-31.rst b/doc/opal-api/opal-pci-set-pe-31.rst index a101b90ca32e..41df454400f2 100644 --- a/doc/opal-api/opal-pci-set-pe-31.rst +++ b/doc/opal-api/opal-pci-set-pe-31.rst @@ -1,9 +1,17 @@ +.. _OPAL_PCI_SET_PE: + OPAL_PCI_SET_PE =============== -:: + +.. code-block:: c #define OPAL_PCI_SET_PE 31 + int64_t opal_pci_set_pe(uint64_t phb_id, uint64_t pe_number, + uint64_t bus_dev_func, uint8_t bus_compare, + uint8_t dev_compare, uint8_t func_compare, + uint8_t pe_action); + **NOTE:** The following two paragraphs come from some old documentation and have not been checked for accuracy. Same goes for bus_compare, dev_compare and func_compare documentation. Do *NOT* assume this documentation is correct @@ -21,12 +29,6 @@ argument, for OPAL to correlate the RID (bus/dev/func) domain of the PE. If a PE domain is changed, the host must call this to reset the PE bus/dev/func domain and then call all other OPAL calls that map PHB IODA resources to update those domains within PHB facilities. -:: - - static int64_t opal_pci_set_pe(uint64_t phb_id, uint64_t pe_number, - uint64_t bus_dev_func, uint8_t bus_compare, - uint8_t dev_compare, uint8_t func_compare, - uint8_t pe_action) ``phb_id`` is the value from the PHB node ibm,opal-phbid property. @@ -75,17 +77,17 @@ update those domains within PHB facilities. OPAL_MAP_PE = 1 }; -Return value: +Returns +------- -OPAL_PARAMETER +:ref:`OPAL_PARAMETER` If one of the following: - - invalid phb - - invalid pe_action - - invalid bus_dev_func - - invalid bus_compare -OPAL_UNSUPPORTED + - invalid phb + - invalid pe_action + - invalid bus_dev_func + - invalid bus_compare +:ref:`OPAL_UNSUPPORTED` PHB does not support set_pe operation - -OPAL_SUCCESS - if opreation was successful +:ref:`OPAL_SUCCESS` + if operation was successful From patchwork Fri May 31 06:13:16 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108138 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZRw4dghz9s00 for ; Fri, 31 May 2019 16:34:36 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZRw3lGyzDqvT for ; Fri, 31 May 2019 16:34:36 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P2NgQzDqZV for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098417.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V669dg145241 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e11.ny.us.ibm.com (e11.ny.us.ibm.com [129.33.205.201]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvp63v1p-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e11.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b01cxnp23032.gho.pok.ibm.com (9.57.198.27) by e11.ny.us.ibm.com (146.89.104.198) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b01ledav002.gho.pok.ibm.com (b01ledav002.gho.pok.ibm.com [9.57.199.107]) by b01cxnp23032.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E56e35455336 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 7DA3212405C for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 3A7F3124058 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav002.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id C32D150CBC6; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:16 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-2213-0000-0000-0000039856B0 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:07 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-2214-0000-0000-00005EA4D941 Message-Id: <20190531061351.22973-76-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 075/110] doc: prettify OPAL_PCI_SET_PELTV X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-set-peltv-32.rst | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/doc/opal-api/opal-pci-set-peltv-32.rst b/doc/opal-api/opal-pci-set-peltv-32.rst index 9cc13a24645e..acb2d479a2fe 100644 --- a/doc/opal-api/opal-pci-set-peltv-32.rst +++ b/doc/opal-api/opal-pci-set-peltv-32.rst @@ -1,17 +1,19 @@ +.. _OPAL_PCI_SET_PELTV: + OPAL_PCI_SET_PELTV ================== -:: + +.. code-block:: c #define OPAL_PCI_SET_PELTV 32 + int64_t opal_pci_set_peltv(uint64_t phb_id, uint32_t parent_pe, + uint32_t child_pe, uint8_t state); + **WARNING:** This documentation comes from an old source and is possibly not up to date with OPALv3. Rely on this documentation only as a starting point, use the source (and update the docs). -:: - - static int64_t opal_pci_set_peltv(uint64_t phb_id, uint32_t parent_pe, - uint32_t child_pe, uint8_t state) This call sets the PELTV of a parent PE to add or remove a PE number as a PE within that parent PE domain. The host must call this function for each child @@ -38,7 +40,7 @@ of a parent PE. and the upstream bridge PE of that switch -- an ERR_Fatal from either bridge should result in a collateral freeze of that device PE. -:: +.. code-block:: c enum OpalPeltvAction { OPAL_REMOVE_PE_FROM_DOMAIN = 0, @@ -52,7 +54,9 @@ PE when the state argument is '1'. OPAL clears the PELTV bit in all RTT entries for the parent PE when the state argument is '0' and setting the child PE bit in the parent PELTV results in an all-zeros value for that PELTV. -Return value: :: +Return value: + +.. code-block:: c if (!phb) return OPAL_PARAMETER; From patchwork Fri May 31 06:13:17 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108134 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZR80C5qz9s00 for ; Fri, 31 May 2019 16:33:56 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZR762HrzDqn4 for ; Fri, 31 May 2019 16:33:55 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P28g7zDqZT for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098420.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V6Auar086659 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e32.co.us.ibm.com (e32.co.us.ibm.com [32.97.110.150]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxsbg1u2-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e32.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e32.co.us.ibm.com (192.168.1.132) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b03ledav001.gho.boulder.ibm.com (b03ledav001.gho.boulder.ibm.com [9.17.130.232]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5eT21954928 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 6591D6E050 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 2EFF96E04C for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav001.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id C85E150CBC9; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:17 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0004-0000-0000-0000151674FC X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:07 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0005-0000-0000-00008BDE97A7 Message-Id: <20190531061351.22973-77-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=790 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 076/110] doc: prettify OPAL_PCI_SET_MVE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-set-mve-33.rst | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/doc/opal-api/opal-pci-set-mve-33.rst b/doc/opal-api/opal-pci-set-mve-33.rst index bf5358727295..b0c7e6111e0d 100644 --- a/doc/opal-api/opal-pci-set-mve-33.rst +++ b/doc/opal-api/opal-pci-set-mve-33.rst @@ -1,11 +1,13 @@ +.. _OPAL_PCI_SET_MVE: + OPAL_PCI_SET_MVE ================ -:: + +.. code-block:: c #define OPAL_PCI_SET_MVE 33 - static int64_t opal_pci_set_mve(uint64_t phb_id, uint32_t mve_number, - uint64_t pe_number) + int64_t opal_pci_set_mve(uint64_t phb_id, uint32_t mve_number, uint64_t pe_number); **WARNING:** following documentation is from old sources, and is possibly not representative of OPALv3 as implemented by skiboot. This should be @@ -31,7 +33,9 @@ determine the PE domain. OPAL treats this call as a NOP for IODA2 PHBs and returns a status of OPAL_SUCCESS. -Return value: :: +Return value: + +.. code-block:: c if (!phb) return OPAL_PARAMETER; From patchwork Fri May 31 06:13:18 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108127 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZPd4Knmz9s00 for ; Fri, 31 May 2019 16:32:37 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZPd2sBDzDqh2 for ; Fri, 31 May 2019 16:32:37 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N6cw0zDqZH for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098417.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V666uE145157 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e35.co.us.ibm.com (e35.co.us.ibm.com [32.97.110.153]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvp63v1f-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e35.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e35.co.us.ibm.com (192.168.1.135) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b03ledav001.gho.boulder.ibm.com (b03ledav001.gho.boulder.ibm.com [9.17.130.232]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E58V23921008 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 6AA336E052 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 341076E04E for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav001.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id CC87650CBCA; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:18 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0012-0000-0000-0000173DDCFC X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:07 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0013-0000-0000-00005778F80C Message-Id: <20190531061351.22973-78-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=765 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 077/110] doc: prettify OPAL_PCI_SET_MVE_ENABLE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-set-mve-enable-34.rst | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/doc/opal-api/opal-pci-set-mve-enable-34.rst b/doc/opal-api/opal-pci-set-mve-enable-34.rst index 44af37f64d80..55bf10a08f21 100644 --- a/doc/opal-api/opal-pci-set-mve-enable-34.rst +++ b/doc/opal-api/opal-pci-set-mve-enable-34.rst @@ -1,11 +1,14 @@ +.. _OPAL_PCI_SET_MVE_ENABLE: + OPAL_PCI_SET_MVE_ENABLE ======================= -:: + + +.. code-block:: c #define OPAL_PCI_SET_MVE_ENABLE 34 - static int64_t opal_pci_set_mve_enable(uint64_t phb_id, uint32_t mve_number, - uint32_t state) + int64_t opal_pci_set_mve_enable(uint64_t phb_id, uint32_t mve_number, uint32_t state); enum OpalMveEnableAction { OPAL_DISABLE_MVE = 0, @@ -31,7 +34,9 @@ DMA address and message data value. This call sets the MVE to an enabled (1) or disabled (0) state. -Return value: :: +Return value: + +.. code-block:: c if (!phb) return OPAL_PARAMETER; From patchwork Fri May 31 06:13:19 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108132 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZQm0tnTz9s00 for ; Fri, 31 May 2019 16:33:36 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZQl73HnzDqfv for ; Fri, 31 May 2019 16:33:35 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P0gQLzDqYp for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098396.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64AYM038017 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e32.co.us.ibm.com (e32.co.us.ibm.com [32.97.110.150]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4v1d68-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e32.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e32.co.us.ibm.com (192.168.1.132) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5o227787704 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id A0FBFC605A for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 3D391C6057 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id D16FE50CBCD; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:19 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0004-0000-0000-0000151674FE X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:07 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0005-0000-0000-00008BDE97A8 Message-Id: <20190531061351.22973-79-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=924 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 078/110] Remove unused OPAL_PCI_GET_XIVE_REISSUE and OPAL_PCI_SET_XIVE_REISSUE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" These seem to be remnants of one of the OPAL incarnations prior to OPALv3. These calls have never been implemented in skiboot, and never used by an upstream kernel (nor a PowerKVM kernel). It's rather safe to just document them as never existing. Signed-off-by: Stewart Smith Reviewed-by: Andrew Donnellan --- core/pci-opal.c | 20 ------------- doc/opal-api/index.rst | 28 +++++++++++++++++-- .../opal-pci-get-set-xive-reissue-35-36.rst | 18 ------------ include/opal-api.h | 4 +-- 4 files changed, 28 insertions(+), 42 deletions(-) delete mode 100644 doc/opal-api/opal-pci-get-set-xive-reissue-35-36.rst diff --git a/core/pci-opal.c b/core/pci-opal.c index 9b8d4000490b..2d2178681fb7 100644 --- a/core/pci-opal.c +++ b/core/pci-opal.c @@ -321,26 +321,6 @@ static int64_t opal_pci_set_mve_enable(uint64_t phb_id, uint32_t mve_number, } opal_call(OPAL_PCI_SET_MVE_ENABLE, opal_pci_set_mve_enable, 3); -static int64_t opal_pci_get_xive_reissue(uint64_t phb_id __unused, - uint32_t xive_number __unused, - uint8_t *p_bit __unused, - uint8_t *q_bit __unused) -{ - /* IODA2 (P8) stuff, TODO */ - return OPAL_UNSUPPORTED; -} -opal_call(OPAL_PCI_GET_XIVE_REISSUE, opal_pci_get_xive_reissue, 4); - -static int64_t opal_pci_set_xive_reissue(uint64_t phb_id __unused, - uint32_t xive_number __unused, - uint8_t p_bit __unused, - uint8_t q_bit __unused) -{ - /* IODA2 (P8) stuff, TODO */ - return OPAL_UNSUPPORTED; -} -opal_call(OPAL_PCI_SET_XIVE_REISSUE, opal_pci_set_xive_reissue, 4); - static int64_t opal_pci_msi_eoi(uint64_t phb_id, uint32_t hwirq) { diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 6e7a8a16869f..1c9af3953f25 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -89,9 +89,11 @@ The OPAL API is the interface between an Operating System and OPAL. +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_SET_MVE_ENABLE` | 34 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_PCI_GET_XIVE_REISSUE` | 35 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_PCI_GET_XIVE_REISSUE` | 35 | Never | | Never used or | +| | | | | Implemented | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_PCI_SET_XIVE_REISSUE` | 36 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_PCI_SET_XIVE_REISSUE` | 36 | Never | | Never used or | +| | | | | Implemented | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_SET_XIVE_PE` | 37 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -390,6 +392,10 @@ removed and no longer supported. +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_SET_PHB_TABLE_MEMORY` | 30 | Never | | +---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_PCI_GET_XIVE_REISSUE` | 35 | Never | | ++---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_PCI_GET_XIVE_REISSUE` | 36 | Never | | ++---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_WRITE_OPPANEL` | 43 | pre-v1.0 | pre-v1.0 | +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_OLD_I2C_REQUEST` | 106 | v4.0 | v4.0 | @@ -430,6 +436,24 @@ OPAL_PCI_SET_PHB_TABLE_MEMORY A remnant of an old API design. Never implemented, never used. Only ever returned :ref:`OPAL_UNSUPPORTED`, now the call is not implemented at all. +.. _OPAL_PCI_GET_XIVE_REISSUE: + +OPAL_PCI_GET_XIVE_REISSUE +^^^^^^^^^^^^^^^^^^^^^^^^^ + +A remnant of something prior to OPALv3. Never implemented in skiboot and never +used by anyone. Returend :ref:`OPAL_UNSUPPORTED` until :ref:`skiboot-6.4`, where +it was removed. + +.. _OPAL_PCI_SET_XIVE_REISSUE: + +OPAL_PCI_SET_XIVE_REISSUE +^^^^^^^^^^^^^^^^^^^^^^^^^ + +A remnant of something prior to OPALv3. Never implemented in skiboot and never +used by anyone. Returend :ref:`OPAL_UNSUPPORTED` until :ref:`skiboot-6.4`, where +it was removed. + .. _OPAL_WRITE_OPPANEL: OPAL_WRITE_OPPANEL diff --git a/doc/opal-api/opal-pci-get-set-xive-reissue-35-36.rst b/doc/opal-api/opal-pci-get-set-xive-reissue-35-36.rst deleted file mode 100644 index 5c4e68573aeb..000000000000 --- a/doc/opal-api/opal-pci-get-set-xive-reissue-35-36.rst +++ /dev/null @@ -1,18 +0,0 @@ -OPAL_PCI_GET_XIVE_REISSUE and OPAL_PCI_SET_XIVE_REISSUE -======================================================= -:: - - static int64_t opal_pci_get_xive_reissue(uint64_t phb_id __unused, - uint32_t xive_number __unused, - uint8_t *p_bit __unused, - uint8_t *q_bit __unused) - - static int64_t opal_pci_set_xive_reissue(uint64_t phb_id __unused, - uint32_t xive_number __unused, - uint8_t p_bit __unused, - uint8_t q_bit __unused) - - -Both of these calls are remnants from previous OPAL versions, calling either -of them shall return ``OPAL_UNSUPPORTED``. - diff --git a/include/opal-api.h b/include/opal-api.h index f767d3c199a9..b7facf41fdbf 100644 --- a/include/opal-api.h +++ b/include/opal-api.h @@ -94,8 +94,8 @@ #define OPAL_PCI_SET_PELTV 32 #define OPAL_PCI_SET_MVE 33 #define OPAL_PCI_SET_MVE_ENABLE 34 -#define OPAL_PCI_GET_XIVE_REISSUE 35 -#define OPAL_PCI_SET_XIVE_REISSUE 36 +#define OPAL_PCI_GET_XIVE_REISSUE 35 /* never implemented */ +#define OPAL_PCI_SET_XIVE_REISSUE 36 /* never implemented */ #define OPAL_PCI_SET_XIVE_PE 37 #define OPAL_GET_XIVE_SOURCE 38 #define OPAL_GET_MSI_32 39 From patchwork Fri May 31 06:13:20 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108123 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZNj27jYz9s00 for ; Fri, 31 May 2019 16:31:49 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZNj19dMzDqg8 for ; Fri, 31 May 2019 16:31:49 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N6MvzzDqYn for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098410.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V647nY140910 for ; Fri, 31 May 2019 02:14:10 -0400 Received: from e36.co.us.ibm.com (e36.co.us.ibm.com [32.97.110.154]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4vsaa7-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:08 -0400 Received: from localhost by e36.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:07 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e36.co.us.ibm.com (192.168.1.136) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5eS23921010 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 7ABF6C605B for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 434C9C605A for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id D5A1850CBCE; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:20 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0020-0000-0000-00000EF27380 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:07 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0021-0000-0000-000066081ED9 Message-Id: <20190531061351.22973-80-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=849 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 079/110] doc: prettify OPAL_PCI_SET_XIVE_PE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-set-xive-pe-37.rst | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/doc/opal-api/opal-pci-set-xive-pe-37.rst b/doc/opal-api/opal-pci-set-xive-pe-37.rst index a5c658208580..9f7badffc3c5 100644 --- a/doc/opal-api/opal-pci-set-xive-pe-37.rst +++ b/doc/opal-api/opal-pci-set-xive-pe-37.rst @@ -1,9 +1,13 @@ +.. _OPAL_PCI_SET_XIVE_PE: + OPAL_PCI_SET_XIVE_PE ==================== -:: - static int64_t opal_pci_set_xive_pe(uint64_t phb_id, uint64_t pe_number, - uint32_t xive_num) +.. code-block:: c + + #define OPAL_PCI_SET_XIVE_PE 37 + + int64_t opal_pci_set_xive_pe(uint64_t phb_id, uint64_t pe_number, uint32_t xive_num); **WARNING:** following documentation is from old sources, and is possibly not representative of OPALv3 as implemented by skiboot. This should be @@ -25,7 +29,9 @@ This call maps the XIVR indexed by xive_num to the PE specified by pe_number. For ibm,opal-ioda HW, the pe_number must match the pe_number set in the MVE. -Return value: :: +Return value: + +.. code-block:: c if (!phb) return OPAL_PARAMETER; From patchwork Fri May 31 06:13:21 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108122 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZNW138rz9s00 for ; Fri, 31 May 2019 16:31:39 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZNV6tnjzDqdP for ; Fri, 31 May 2019 16:31:38 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N5Fq8zDqXv for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098414.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V63xsX133756 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e32.co.us.ibm.com (e32.co.us.ibm.com [32.97.110.150]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stwdwjr2v-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e32.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b03cxnp07028.gho.boulder.ibm.com (9.17.130.15) by e32.co.us.ibm.com (192.168.1.132) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp07028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5Sx12124464 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id BFF6A6A04D for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 4F3286A047 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id DAE1150CBD0; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:21 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0004-0000-0000-0000151674FD X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:07 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0005-0000-0000-00008BDE97AA Message-Id: <20190531061351.22973-81-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=924 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 080/110] Remove unused OPAL_GET_XIVE_SOURCE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" While this call was technically implemented by skiboot, no code has ever called it, and it was only ever implemented for the p7ioc-phb back-end (i.e. POWER7). Since this call was unused in Linux, and that POWER7 with OPAL was only ever available internally, so it should be safe to remove the call. Signed-off-by: Stewart Smith --- core/pci-opal.c | 21 ---------------- doc/opal-api/index.rst | 16 +++++++++++- doc/opal-api/opal-get-xive-source-38.rst | 32 ------------------------ hw/p7ioc-phb.c | 14 ----------- include/pci.h | 3 --- 5 files changed, 15 insertions(+), 71 deletions(-) delete mode 100644 doc/opal-api/opal-get-xive-source-38.rst diff --git a/core/pci-opal.c b/core/pci-opal.c index 2d2178681fb7..043d9483c026 100644 --- a/core/pci-opal.c +++ b/core/pci-opal.c @@ -378,27 +378,6 @@ static int64_t opal_pci_set_xive_pe(uint64_t phb_id, uint64_t pe_number, } opal_call(OPAL_PCI_SET_XIVE_PE, opal_pci_set_xive_pe, 3); -static int64_t opal_get_xive_source(uint64_t phb_id, uint32_t xive_num, - int32_t *interrupt_source_number) -{ - struct phb *phb = pci_get_phb(phb_id); - int64_t rc; - - if (!opal_addr_valid(interrupt_source_number)) - return OPAL_PARAMETER; - - if (!phb) - return OPAL_PARAMETER; - if (!phb->ops->get_xive_source) - return OPAL_UNSUPPORTED; - phb_lock(phb); - rc = phb->ops->get_xive_source(phb, xive_num, interrupt_source_number); - phb_unlock(phb); - - return rc; -} -opal_call(OPAL_GET_XIVE_SOURCE, opal_get_xive_source, 3); - static int64_t opal_get_msi_32(uint64_t phb_id, uint32_t mve_number, uint32_t xive_num, uint8_t msi_range, uint32_t *msi_address, uint32_t *message_data) diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 1c9af3953f25..d0e6483fceb1 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -97,7 +97,8 @@ The OPAL API is the interface between an Operating System and OPAL. +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_SET_XIVE_PE` | 37 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_GET_XIVE_SOURCE` | 38 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_GET_XIVE_SOURCE` | 38 | v1.0 (Initial Release) | POWER8 | Never used, | +| | | | | now removed. | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_GET_MSI_32` | 39 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -396,6 +397,8 @@ removed and no longer supported. +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_GET_XIVE_REISSUE` | 36 | Never | | +---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_GET_XIVE_SOURCE` | 38 | v1.0 Initial Release | :ref:`skiboot-6.4` | ++---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_WRITE_OPPANEL` | 43 | pre-v1.0 | pre-v1.0 | +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_OLD_I2C_REQUEST` | 106 | v4.0 | v4.0 | @@ -454,6 +457,17 @@ A remnant of something prior to OPALv3. Never implemented in skiboot and never used by anyone. Returend :ref:`OPAL_UNSUPPORTED` until :ref:`skiboot-6.4`, where it was removed. +.. _OPAL_GET_XIVE_SOURCE: + +OPAL_GET_XIVE_SOURCE +^^^^^^^^^^^^^^^^^^^^ + +While this call was technically implemented by skiboot, no code has ever called +it, and it was only ever implemented for the p7ioc-phb back-end (i.e. POWER7). +Since this call was unused in Linux, and that POWER7 with OPAL was only ever +available internally, it was determined that it was safe to remove this call as +of :ref:`skiboot-6.4`. + .. _OPAL_WRITE_OPPANEL: OPAL_WRITE_OPPANEL diff --git a/doc/opal-api/opal-get-xive-source-38.rst b/doc/opal-api/opal-get-xive-source-38.rst deleted file mode 100644 index 2989c803efab..000000000000 --- a/doc/opal-api/opal-get-xive-source-38.rst +++ /dev/null @@ -1,32 +0,0 @@ -OPAL_GET_XIVE_SOURCE -==================== -:: - - This function validates the given ``xive_num`` and sets the - ``interrupt_source_number``. Then returns the proper return code. - -Parameters ----------- - -``phb_id`` - The ``phb_id`` parameter is the value from the PHB node ``ibm,opal-phbid`` - property. - -``xive_num`` - The ``xive_num`` is the index of an XIVE that corresponds to a particular - interrupt. - -``interrupt_source_number`` - The ``interrupt_source_number`` is a value formed by the combination of the - device tree MSI property base BUID and ``xive_num`` - -Return Codes ------------- -``OPAL_PARAMETER`` - The indicated ``phb_id`` not found - -``OPAL_UNSUPPORTED`` - Presence retrieval not supported on the ``phb_id`` - -``OPAL_SUCCESS`` - Indicates Success! diff --git a/hw/p7ioc-phb.c b/hw/p7ioc-phb.c index 47f4f3c9e0c6..97730a0be989 100644 --- a/hw/p7ioc-phb.c +++ b/hw/p7ioc-phb.c @@ -1312,19 +1312,6 @@ static int64_t p7ioc_set_xive_pe(struct phb *phb, uint64_t pe_number, return OPAL_SUCCESS; } -static int64_t p7ioc_get_xive_source(struct phb *phb, uint32_t xive_num, - int32_t *interrupt_source_number) -{ - struct p7ioc_phb *p = phb_to_p7ioc_phb(phb); - - if (xive_num > 255 || !interrupt_source_number) - return OPAL_PARAMETER; - - *interrupt_source_number = (p->buid_msi << 4) | xive_num; - - return OPAL_SUCCESS; -} - static int64_t p7ioc_get_msi_32(struct phb *phb __unused, uint64_t mve_number, uint32_t xive_num, uint8_t msi_range, uint32_t *msi_address, uint32_t *message_data) @@ -2330,7 +2317,6 @@ static const struct phb_ops p7ioc_phb_ops = { .set_mve = p7ioc_set_mve, .set_mve_enable = p7ioc_set_mve_enable, .set_xive_pe = p7ioc_set_xive_pe, - .get_xive_source = p7ioc_get_xive_source, .get_msi_32 = p7ioc_get_msi_32, .get_msi_64 = p7ioc_get_msi_64, .ioda_reset = p7ioc_ioda_reset, diff --git a/include/pci.h b/include/pci.h index cf06dc36b723..b63b1193a806 100644 --- a/include/pci.h +++ b/include/pci.h @@ -321,9 +321,6 @@ struct phb_ops { int64_t (*set_xive_pe)(struct phb *phb, uint64_t pe_number, uint32_t xive_num); - int64_t (*get_xive_source)(struct phb *phb, uint32_t xive_num, - int32_t *interrupt_source_number); - int64_t (*get_msi_32)(struct phb *phb, uint64_t mve_number, uint32_t xive_num, uint8_t msi_range, uint32_t *msi_address, uint32_t *message_data); From patchwork Fri May 31 06:13:22 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108146 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZTz5xdGz9s00 for ; Fri, 31 May 2019 16:36:23 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZTz42LBzDqsj for ; Fri, 31 May 2019 16:36:23 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0Q1NtdzDqZm for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098417.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V668Bv145223 for ; Fri, 31 May 2019 02:14:10 -0400 Received: from e35.co.us.ibm.com (e35.co.us.ibm.com [32.97.110.153]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvp63v1x-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:10 -0400 Received: from localhost by e35.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:09 +0100 Received: from b03cxnp07028.gho.boulder.ibm.com (9.17.130.15) by e35.co.us.ibm.com (192.168.1.135) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp07028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5Z07995868 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id A1B906A04F for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 6A5CD6A04D for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id DF79B50CBD2; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:22 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0012-0000-0000-0000173DDCFE X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0013-0000-0000-00005778F80E Message-Id: <20190531061351.22973-82-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=790 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 081/110] doc: prettify OPAL_GET_MSI_[32|64] X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-get-msi-39-40.rst | 45 +++++++++++++++++++++++++++-- 1 file changed, 42 insertions(+), 3 deletions(-) diff --git a/doc/opal-api/opal-get-msi-39-40.rst b/doc/opal-api/opal-get-msi-39-40.rst index 14bd980b8495..86741ce22a49 100644 --- a/doc/opal-api/opal-get-msi-39-40.rst +++ b/doc/opal-api/opal-get-msi-39-40.rst @@ -1,10 +1,49 @@ +=================================== OPAL_GET_MSI_32 and OPAL_GET_MSI_64 =================================== -:: + +.. code-block:: c + + #define OPAL_GET_MSI_32 39 + #define OPAL_GET_MSI_64 40 + + int64_t opal_get_msi_32(uint64_t phb_id, uint32_t mve_number, + uint32_t xive_num, uint8_t msi_range, + uint32_t *msi_address, uint32_t *message_data); + + int64_t opal_get_msi_64(uint64_t phb_id, uint32_t mve_number, + uint32_t xive_num, uint8_t msi_range, + uint64_t *msi_address, uint32_t *message_data); + +.. _OPAL_GET_MSI_32: + +OPAL_GET_MSI_32 +=============== + +.. code-block:: c #define OPAL_GET_MSI_32 39 + + int64_t opal_get_msi_32(uint64_t phb_id, uint32_t mve_number, + uint32_t xive_num, uint8_t msi_range, + uint32_t *msi_address, uint32_t *message_data); + +See :ref:`OPAL_GET_MSI_64`. + +.. _OPAL_GET_MSI_64: + +OPAL_GET_MSI_64 +=============== + +.. code-block:: c + #define OPAL_GET_MSI_64 40 + int64_t opal_get_msi_64(uint64_t phb_id, uint32_t mve_number, + uint32_t xive_num, uint8_t msi_range, + uint64_t *msi_address, uint32_t *message_data); + + **WARNING:** the following documentation is from old sources, and is possibly not representative of OPALv3 as implemented by skiboot. This should be used as a starting point for full documentation. @@ -34,14 +73,14 @@ returns the MSI DMA message data value the PE uses to signal that interrupt. MSI DMA address must be unique for any given consecutive power of 2 set of 32 message data values,. which in turn select particular PHB XIVEs. This value must be a power of 2 value in the range of 0 to 32. OPAL - returns opal_parameter for values outside of this range. + returns :ref:`OPAL_PARAMETER` for values outside of this range. For MSI conventional, the MSI address and message data returned apply to a power of 2 sequential set of XIVRs starting from the xive_number for the power of 2 msi_range input argument. The message data returned represents the power of 2 aligned starting message data value of the first interrupt number in that sequential range. Valid msi_range input values are from 1 to 32. -Non-power of 2 values result in a return code of opal_PARAMETER . +Non-power of 2 values result in a return code of :ref:`OPAL_PARAMETER`. An msi_range value of 0 or 1 signifies that OPAL should return the message data and message address for exactly one MSI specified by the input XIVE From patchwork Fri May 31 06:13:23 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108143 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZT84wNhz9s00 for ; Fri, 31 May 2019 16:35:40 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZT83vB0zDqmJ for ; Fri, 31 May 2019 16:35:40 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P2P4tzDqZW for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098414.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V63xsY133756 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e35.co.us.ibm.com (e35.co.us.ibm.com [32.97.110.153]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stwdwjr36-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e35.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e35.co.us.ibm.com (192.168.1.135) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5m325559370 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id A736DC605B for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 6FD04C6055 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id E3FD550CBD3; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:23 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0012-0000-0000-0000173DDD00 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0013-0000-0000-00005778F80F Message-Id: <20190531061351.22973-83-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 082/110] doc: Document OPAL_QUERY_CPU_STATUS X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- 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 --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. From patchwork Fri May 31 06:13:24 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108135 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZRL0DH7z9s00 for ; Fri, 31 May 2019 16:34:06 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZRK6ShLzDqnv for ; Fri, 31 May 2019 16:34:05 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P1mKtzDqZR for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098419.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V655Vl135191 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e31.co.us.ibm.com (e31.co.us.ibm.com [32.97.110.149]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stv224n63-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e31.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b03cxnp07029.gho.boulder.ibm.com (9.17.130.16) by e31.co.us.ibm.com (192.168.1.131) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b03ledav002.gho.boulder.ibm.com (b03ledav002.gho.boulder.ibm.com [9.17.130.233]) by b03cxnp07029.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5L911927866 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b03ledav002.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id AF51213604F for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b03ledav002.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 787A8136055 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav002.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id EA39F50CBD4; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:24 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-8235-0000-0000-00000EA0F3AD X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:07 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-8236-0000-0000-000045C9C0F3 Message-Id: <20190531061351.22973-84-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=640 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 083/110] doc: prettify OPAL_PCI_MAP_PE_DMA_WINDOW[_REAL] X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-map-pe-dma-window-44.rst | 11 ++++++++--- .../opal-pci-map-pe-dma-window-real-45.rst | 14 ++++++++++++-- 2 files changed, 20 insertions(+), 5 deletions(-) diff --git a/doc/opal-api/opal-pci-map-pe-dma-window-44.rst b/doc/opal-api/opal-pci-map-pe-dma-window-44.rst index bec8f087c18e..9450629f0d1d 100644 --- a/doc/opal-api/opal-pci-map-pe-dma-window-44.rst +++ b/doc/opal-api/opal-pci-map-pe-dma-window-44.rst @@ -1,6 +1,9 @@ +.. _OPAL_PCI_MAP_PE_DMA_WINDOW: + OPAL_PCI_MAP_PE_DMA_WINDOW ========================== -:: + +.. code-block:: c #define OPAL_PCI_MAP_PE_DMA_WINDOW 44 @@ -10,7 +13,7 @@ OPAL_PCI_MAP_PE_DMA_WINDOW uint16_t tce_levels, uint64_t tce_table_addr, uint64_t tce_table_size, - uint64_t tce_page_size) + uint64_t tce_page_size); **WARNING:** following documentation is from old sources, and is possibly not representative of OPALv3 as implemented by skiboot. This should be @@ -94,7 +97,9 @@ a win_size_32 = 256MB, only 16 DMA windows (and therefore no more than 16 distinct PEs) can map the 4GB of 32-bit PCI memory for DMA. OPAL does not police this limitation. -Return value: :: +Return value: + +.. code-block:: c if (!phb) return OPAL_PARAMETER; diff --git a/doc/opal-api/opal-pci-map-pe-dma-window-real-45.rst b/doc/opal-api/opal-pci-map-pe-dma-window-real-45.rst index bc364dc4739e..87395d1ee593 100644 --- a/doc/opal-api/opal-pci-map-pe-dma-window-real-45.rst +++ b/doc/opal-api/opal-pci-map-pe-dma-window-real-45.rst @@ -1,9 +1,19 @@ +.. _OPAL_PCI_MAP_PE_DMA_WINDOW_REAL: + OPAL_PCI_MAP_PE_DMA_WINDOW_REAL =============================== -:: + +.. code-block:: c #define OPAL_PCI_MAP_PE_DMA_WINDOW_REAL 45 + int64_t opal_pci_map_pe_dma_window_real(uint64_t phb_id, + uint64_t pe_number, + uint16_t window_id, + uint64_t pci_start_addr, + uint64_t pci_mem_size); + + **WARNING:** following documentation is from old sources, and is possibly not representative of OPALv3 as implemented by skiboot. This should be used as a starting point for full documentation. @@ -40,6 +50,6 @@ within the window set associated with the specified PE number. ``window_size`` is the size, in bytes, of the address range defined by this - window. This value must be a multiple of 16MB; OPAL returns OPAL_PARAMETER + window. This value must be a multiple of 16MB; OPAL returns :ref:`OPAL_PARAMETER` for any value that is not a multiple of 16MB. A value of '0' indicates to disable this DMA window. From patchwork Fri May 31 06:13:25 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108137 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZRl1LNNz9s00 for ; Fri, 31 May 2019 16:34:27 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZRk6lm6zDqtj for ; Fri, 31 May 2019 16:34:26 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P3lVKzDqXw for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098414.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V63wI6133745 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e12.ny.us.ibm.com (e12.ny.us.ibm.com [129.33.205.202]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stwdwjr30-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e12.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b01cxnp23033.gho.pok.ibm.com (9.57.198.28) by e12.ny.us.ibm.com (146.89.104.199) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:06 +0100 Received: from b01ledav004.gho.pok.ibm.com (b01ledav004.gho.pok.ibm.com [9.57.199.109]) by b01cxnp23033.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E5x237814540 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:05 GMT Received: from b01ledav004.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id C9774112062 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from b01ledav004.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 85758112061 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav004.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id EEF7450CBD7; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:25 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0060-0000-0000-0000034A56E3 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0061-0000-0000-0000498FD379 Message-Id: <20190531061351.22973-85-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=912 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 084/110] doc: Add skeleton OPAL_PCI_RESET docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-reset-49.rst | 42 ++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 doc/opal-api/opal-pci-reset-49.rst diff --git a/doc/opal-api/opal-pci-reset-49.rst b/doc/opal-api/opal-pci-reset-49.rst new file mode 100644 index 000000000000..85acc0bb7304 --- /dev/null +++ b/doc/opal-api/opal-pci-reset-49.rst @@ -0,0 +1,42 @@ +.. _OPAL_PCI_RESET: + +OPAL_PCI_RESET +============== + +.. code-block:: c + + #define OPAL_PCI_RESET 49 + + enum OpalPciResetScope { + OPAL_RESET_PHB_COMPLETE = 1, + OPAL_RESET_PCI_LINK = 2, + OPAL_RESET_PHB_ERROR = 3, + OPAL_RESET_PCI_HOT = 4, + OPAL_RESET_PCI_FUNDAMENTAL = 5, + OPAL_RESET_PCI_IODA_TABLE = 6 + }; + + enum OpalPciResetState { + OPAL_DEASSERT_RESET = 0, + OPAL_ASSERT_RESET = 1 + }; + + int64_t opal_pci_reset(uint64_t id, uint8_t reset_scope, uint8_t assert_state); + +Kick off the requested PCI reset operation. This starts a state machine off to +perform the requested operation. This call will return how many milliseconds to +wait before calling back into :ref:`OPAL_PCI_POLL`. An OS can +call :ref:`OPAL_PCI_POLL` earlier, but it is unlikely any progress will have +been made. + + +Returns +------- + +:ref:`OPAL_PARAMETER` + Invalid ``id``, ``reset_scope``, or ``assert_state``. +:ref:`OPAL_UNSUPPORTED` + Operation is unsupported on ``id``. +value > 0 + How many ms to wait for the state machine to crank. + Call :ref:`OPAL_PCI_POLL` to crank the state machine further. From patchwork Fri May 31 06:13:26 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108109 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZKN3yKPz9s00 for ; Fri, 31 May 2019 16:28:56 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZKN2kVKzDqdx for ; Fri, 31 May 2019 16:28:56 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N2T2YzDqYY for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098420.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V6B3To086894 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from e16.ny.us.ibm.com (e16.ny.us.ibm.com [129.33.205.206]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxsbg1tu-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:08 -0400 Received: from localhost by e16.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b01cxnp23033.gho.pok.ibm.com (9.57.198.28) by e16.ny.us.ibm.com (146.89.104.203) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:07 +0100 Received: from b01ledav001.gho.pok.ibm.com (b01ledav001.gho.pok.ibm.com [9.57.199.106]) by b01cxnp23033.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6kN26345780 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 1BEAF2805A for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id CCE7828060 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav001.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id F37B550CBD8; Fri, 31 May 2019 16:13:57 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:26 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0072-0000-0000-00000435AFC5 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:07 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0073-0000-0000-00004C6D3D0B Message-Id: <20190531061351.22973-86-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 085/110] doc: Skeleton OPAL_PCI_GET_HUB_DIAG_DATA docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- .../opal-pci-get-hub-diag-data-50.rst | 81 +++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 doc/opal-api/opal-pci-get-hub-diag-data-50.rst diff --git a/doc/opal-api/opal-pci-get-hub-diag-data-50.rst b/doc/opal-api/opal-pci-get-hub-diag-data-50.rst new file mode 100644 index 000000000000..e7b2584ec933 --- /dev/null +++ b/doc/opal-api/opal-pci-get-hub-diag-data-50.rst @@ -0,0 +1,81 @@ +.. _OPAL_PCI_GET_HUB_DIAG_DATA: + +OPAL_PCI_GET_HUB_DIAG_DATA +========================== + +.. code-block:: c + + #define OPAL_PCI_GET_HUB_DIAG_DATA 50 + + enum { + OPAL_P7IOC_DIAG_TYPE_NONE = 0, + OPAL_P7IOC_DIAG_TYPE_RGC = 1, + OPAL_P7IOC_DIAG_TYPE_BI = 2, + OPAL_P7IOC_DIAG_TYPE_CI = 3, + OPAL_P7IOC_DIAG_TYPE_MISC = 4, + OPAL_P7IOC_DIAG_TYPE_I2C = 5, + OPAL_P7IOC_DIAG_TYPE_LAST = 6 + }; + + struct OpalIoP7IOCErrorData { + __be16 type; + + /* GEM */ + __be64 gemXfir; + __be64 gemRfir; + __be64 gemRirqfir; + __be64 gemMask; + __be64 gemRwof; + + /* LEM */ + __be64 lemFir; + __be64 lemErrMask; + __be64 lemAction0; + __be64 lemAction1; + __be64 lemWof; + + union { + struct OpalIoP7IOCRgcErrorData { + __be64 rgcStatus; /* 3E1C10 */ + __be64 rgcLdcp; /* 3E1C18 */ + }rgc; + struct OpalIoP7IOCBiErrorData { + __be64 biLdcp0; /* 3C0100, 3C0118 */ + __be64 biLdcp1; /* 3C0108, 3C0120 */ + __be64 biLdcp2; /* 3C0110, 3C0128 */ + __be64 biFenceStatus; /* 3C0130, 3C0130 */ + + uint8_t biDownbound; /* BI Downbound or Upbound */ + }bi; + struct OpalIoP7IOCCiErrorData { + __be64 ciPortStatus; /* 3Dn008 */ + __be64 ciPortLdcp; /* 3Dn010 */ + + uint8_t ciPort; /* Index of CI port: 0/1 */ + }ci; + }; + }; + + int64_t opal_pci_get_hub_diag_data(uint64_t hub_id, void *diag_buffer, uint64_t diag_buffer_len); + +Fetch diagnostic data for an IO hub. Currently, this is only implemented for +p7ioc, which is specific to POWER7, something that was only ever available +internally to IBM for development purposes. + +If :ref:`OPAL_PCI_NEXT_ERROR` error type is `OPAL_EEH_IOC_ERROR` and severity +is `OPAL_EEH_SEV_INF`, then the OS should call :ref:`OPAL_PCI_GET_HUB_DIAG_DATA` +to retreive diagnostic data to log appropriately. + +Returns +------- +:ref:`OPAL_SUCCESS` + Diagnostic data copied successfully +:ref:`OPAL_PARAMETER` + Invalid address, invalid hub ID, or insufficient space in buffer for + diagnostic data. +:ref:`OPAL_UNSUPPORTED` + hub doesn't support retreiving diagnostic data. +:ref:`OPAL_CLOSED` + No pending error. +:ref:`OPAL_INTERNAL_ERROR` + Something went wrong. From patchwork Fri May 31 06:13:27 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108126 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZPP3f68z9s00 for ; Fri, 31 May 2019 16:32:25 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZPP2dH7zDqft for ; Fri, 31 May 2019 16:32:25 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N5zJ4zDqZG for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098420.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V6Au1q086655 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e12.ny.us.ibm.com (e12.ny.us.ibm.com [129.33.205.202]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxsbg1u1-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e12.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b01cxnp23033.gho.pok.ibm.com (9.57.198.28) by e12.ny.us.ibm.com (146.89.104.199) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:07 +0100 Received: from b01ledav001.gho.pok.ibm.com (b01ledav001.gho.pok.ibm.com [9.57.199.106]) by b01cxnp23033.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6QB36897044 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 64D422805A for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id DFBA128068 for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav001.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:05 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 0484C50CBD9; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:27 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0060-0000-0000-0000034A56E4 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0061-0000-0000-0000498FD37B Message-Id: <20190531061351.22973-87-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 086/110] doc: Flesh out OPAL_PCI_GET_PHB_DIAG_DATA2 docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- .../opal-pci-get-phb-diag-data2-64.rst | 262 +++++++++++++++++- 1 file changed, 253 insertions(+), 9 deletions(-) diff --git a/doc/opal-api/opal-pci-get-phb-diag-data2-64.rst b/doc/opal-api/opal-pci-get-phb-diag-data2-64.rst index 58f65dbec55f..7a2f98322ea6 100644 --- a/doc/opal-api/opal-pci-get-phb-diag-data2-64.rst +++ b/doc/opal-api/opal-pci-get-phb-diag-data2-64.rst @@ -1,7 +1,253 @@ +.. _OPAL_PCI_GET_PHB_DIAG_DATA: + +OPAL_PCI_GET_PHB_DIAG_DATA +========================== + +.. note:: This call is deprecated. It has not been used since Linux 3.11-rc1. + Use :ref:`OPAL_PCI_GET_PHB_DIAG_DATA2` instead. + +.. note:: This call may be removed in the future. + + +.. _OPAL_PCI_GET_PHB_DIAG_DATA2: + OPAL_PCI_GET_PHB_DIAG_DATA2 =========================== -Get PCI diagnostic data from a given PHB +.. code-block:: c + + #define OPAL_PCI_GET_PHB_DIAG_DATA2 64 + + /** + * This structure defines the overlay which will be used to store PHB error + * data upon request. + */ + enum { + OPAL_PHB_ERROR_DATA_VERSION_1 = 1, + }; + + enum { + OPAL_PHB_ERROR_DATA_TYPE_P7IOC = 1, + OPAL_PHB_ERROR_DATA_TYPE_PHB3 = 2, + OPAL_PHB_ERROR_DATA_TYPE_PHB4 = 3 + }; + + enum { + OPAL_P7IOC_NUM_PEST_REGS = 128, + OPAL_PHB3_NUM_PEST_REGS = 256, + OPAL_PHB4_NUM_PEST_REGS = 512 + }; + + struct OpalIoPhbErrorCommon { + __be32 version; + __be32 ioType; + __be32 len; + }; + + struct OpalIoP7IOCPhbErrorData { + struct OpalIoPhbErrorCommon common; + + __be32 brdgCtl; + + // P7IOC utl regs + __be32 portStatusReg; + __be32 rootCmplxStatus; + __be32 busAgentStatus; + + // P7IOC cfg regs + __be32 deviceStatus; + __be32 slotStatus; + __be32 linkStatus; + __be32 devCmdStatus; + __be32 devSecStatus; + + // cfg AER regs + __be32 rootErrorStatus; + __be32 uncorrErrorStatus; + __be32 corrErrorStatus; + __be32 tlpHdr1; + __be32 tlpHdr2; + __be32 tlpHdr3; + __be32 tlpHdr4; + __be32 sourceId; + + __be32 rsv3; + + // Record data about the call to allocate a buffer. + __be64 errorClass; + __be64 correlator; + + //P7IOC MMIO Error Regs + __be64 p7iocPlssr; // n120 + __be64 p7iocCsr; // n110 + __be64 lemFir; // nC00 + __be64 lemErrorMask; // nC18 + __be64 lemWOF; // nC40 + __be64 phbErrorStatus; // nC80 + __be64 phbFirstErrorStatus; // nC88 + __be64 phbErrorLog0; // nCC0 + __be64 phbErrorLog1; // nCC8 + __be64 mmioErrorStatus; // nD00 + __be64 mmioFirstErrorStatus; // nD08 + __be64 mmioErrorLog0; // nD40 + __be64 mmioErrorLog1; // nD48 + __be64 dma0ErrorStatus; // nD80 + __be64 dma0FirstErrorStatus; // nD88 + __be64 dma0ErrorLog0; // nDC0 + __be64 dma0ErrorLog1; // nDC8 + __be64 dma1ErrorStatus; // nE00 + __be64 dma1FirstErrorStatus; // nE08 + __be64 dma1ErrorLog0; // nE40 + __be64 dma1ErrorLog1; // nE48 + __be64 pestA[OPAL_P7IOC_NUM_PEST_REGS]; + __be64 pestB[OPAL_P7IOC_NUM_PEST_REGS]; + }; + + struct OpalIoPhb3ErrorData { + struct OpalIoPhbErrorCommon common; + + __be32 brdgCtl; + + /* PHB3 UTL regs */ + __be32 portStatusReg; + __be32 rootCmplxStatus; + __be32 busAgentStatus; + + /* PHB3 cfg regs */ + __be32 deviceStatus; + __be32 slotStatus; + __be32 linkStatus; + __be32 devCmdStatus; + __be32 devSecStatus; + + /* cfg AER regs */ + __be32 rootErrorStatus; + __be32 uncorrErrorStatus; + __be32 corrErrorStatus; + __be32 tlpHdr1; + __be32 tlpHdr2; + __be32 tlpHdr3; + __be32 tlpHdr4; + __be32 sourceId; + + __be32 rsv3; + + /* Record data about the call to allocate a buffer */ + __be64 errorClass; + __be64 correlator; + + /* PHB3 MMIO Error Regs */ + __be64 nFir; /* 000 */ + __be64 nFirMask; /* 003 */ + __be64 nFirWOF; /* 008 */ + __be64 phbPlssr; /* 120 */ + __be64 phbCsr; /* 110 */ + __be64 lemFir; /* C00 */ + __be64 lemErrorMask; /* C18 */ + __be64 lemWOF; /* C40 */ + __be64 phbErrorStatus; /* C80 */ + __be64 phbFirstErrorStatus; /* C88 */ + __be64 phbErrorLog0; /* CC0 */ + __be64 phbErrorLog1; /* CC8 */ + __be64 mmioErrorStatus; /* D00 */ + __be64 mmioFirstErrorStatus; /* D08 */ + __be64 mmioErrorLog0; /* D40 */ + __be64 mmioErrorLog1; /* D48 */ + __be64 dma0ErrorStatus; /* D80 */ + __be64 dma0FirstErrorStatus; /* D88 */ + __be64 dma0ErrorLog0; /* DC0 */ + __be64 dma0ErrorLog1; /* DC8 */ + __be64 dma1ErrorStatus; /* E00 */ + __be64 dma1FirstErrorStatus; /* E08 */ + __be64 dma1ErrorLog0; /* E40 */ + __be64 dma1ErrorLog1; /* E48 */ + __be64 pestA[OPAL_PHB3_NUM_PEST_REGS]; + __be64 pestB[OPAL_PHB3_NUM_PEST_REGS]; + }; + + struct OpalIoPhb4ErrorData { + struct OpalIoPhbErrorCommon common; + + __be32 brdgCtl; + + /* XXX missing UTL registers? */ + + /* PHB4 cfg regs */ + __be32 deviceStatus; + __be32 slotStatus; + __be32 linkStatus; + __be32 devCmdStatus; + __be32 devSecStatus; + + /* cfg AER regs */ + __be32 rootErrorStatus; + __be32 uncorrErrorStatus; + __be32 corrErrorStatus; + __be32 tlpHdr1; + __be32 tlpHdr2; + __be32 tlpHdr3; + __be32 tlpHdr4; + __be32 sourceId; + + /* PHB4 ETU Error Regs */ + __be64 nFir; /* 000 */ + __be64 nFirMask; /* 003 */ + __be64 nFirWOF; /* 008 */ + __be64 phbPlssr; /* 120 */ + __be64 phbCsr; /* 110 */ + __be64 lemFir; /* C00 */ + __be64 lemErrorMask; /* C18 */ + __be64 lemWOF; /* C40 */ + __be64 phbErrorStatus; /* C80 */ + __be64 phbFirstErrorStatus; /* C88 */ + __be64 phbErrorLog0; /* CC0 */ + __be64 phbErrorLog1; /* CC8 */ + __be64 phbTxeErrorStatus; /* D00 */ + __be64 phbTxeFirstErrorStatus; /* D08 */ + __be64 phbTxeErrorLog0; /* D40 */ + __be64 phbTxeErrorLog1; /* D48 */ + __be64 phbRxeArbErrorStatus; /* D80 */ + __be64 phbRxeArbFirstErrorStatus; /* D88 */ + __be64 phbRxeArbErrorLog0; /* DC0 */ + __be64 phbRxeArbErrorLog1; /* DC8 */ + __be64 phbRxeMrgErrorStatus; /* E00 */ + __be64 phbRxeMrgFirstErrorStatus; /* E08 */ + __be64 phbRxeMrgErrorLog0; /* E40 */ + __be64 phbRxeMrgErrorLog1; /* E48 */ + __be64 phbRxeTceErrorStatus; /* E80 */ + __be64 phbRxeTceFirstErrorStatus; /* E88 */ + __be64 phbRxeTceErrorLog0; /* EC0 */ + __be64 phbRxeTceErrorLog1; /* EC8 */ + + /* PHB4 REGB Error Regs */ + __be64 phbPblErrorStatus; /* 1900 */ + __be64 phbPblFirstErrorStatus; /* 1908 */ + __be64 phbPblErrorLog0; /* 1940 */ + __be64 phbPblErrorLog1; /* 1948 */ + __be64 phbPcieDlpErrorLog1; /* 1AA0 */ + __be64 phbPcieDlpErrorLog2; /* 1AA8 */ + __be64 phbPcieDlpErrorStatus; /* 1AB0 */ + __be64 phbRegbErrorStatus; /* 1C00 */ + __be64 phbRegbFirstErrorStatus; /* 1C08 */ + __be64 phbRegbErrorLog0; /* 1C40 */ + __be64 phbRegbErrorLog1; /* 1C48 */ + + __be64 pestA[OPAL_PHB4_NUM_PEST_REGS]; + __be64 pestB[OPAL_PHB4_NUM_PEST_REGS]; + }; + + int64_t opal_pci_get_phb_diag_data2(uint64_t phb_id, void *diag_buffer, uint64_t diag_buffer_len); + +Get PCI diagnostic data from a given PHB. Each PHB present in the device tree +has a ``ibm,phb-diag-data-size`` property which is the size of the diagnostic +data structure that can be returned. + +Each PHB generation has a different structure for diagnostic data, and the +small common structure will allow the OS to work out what format the data +is coming in. + +In future, it's possible that the format will change to be more flexible, and +require less OS support. Parameters ---------- @@ -21,18 +267,16 @@ Retrieve the PHB's diagnostic data. The diagnostic data is stored in the buffer pointed by @diag_buffer. Different PHB versions will store different diagnostics, defined in include/opal-api.h as ``struct OpalIoErrorData``. -``OPAL_PCI_GET_PHB_DIAG_DATA`` is deprecated and ``OPAL_PCI_GET_PHB_DIAG_DATA2`` should be used instead. +:ref:`OPAL_PCI_GET_PHB_DIAG_DATA` is deprecated and +:ref:`OPAL_PCI_GET_PHB_DIAG_DATA2` should be used instead. Return Codes ------------ -OPAL_SUCCESS +:ref:`OPAL_SUCCESS` Diagnostic data has been retrieved and stored successfully - -OPAL_PARAMETER +:ref:`OPAL_PARAMETER` The given buffer is too small to store the diagnostic data - -OPAL_HARDWARE +:ref:`OPAL_HARDWARE` The PHB is in a broken state and its data cannot be retreived - -OPAL_UNSUPPORTED +:ref:`OPAL_UNSUPPORTED` Diagnostic data is not implemented for this PHB type From patchwork Fri May 31 06:13:28 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108148 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZVR0tKWz9s00 for ; Fri, 31 May 2019 16:36:47 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZVQ75C9zDqmQ for ; Fri, 31 May 2019 16:36:46 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0Q0688zDqXX for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098393.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64CBB076028 for ; Fri, 31 May 2019 02:14:10 -0400 Received: from e17.ny.us.ibm.com (e17.ny.us.ibm.com [129.33.205.207]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvha4a61-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:10 -0400 Received: from localhost by e17.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:09 +0100 Received: from b01cxnp22033.gho.pok.ibm.com (9.57.198.23) by e17.ny.us.ibm.com (146.89.104.204) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:07 +0100 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp22033.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6Is28705014 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 8A22EB2066 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 0FE02B2064 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 09A4250CBDB; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:28 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0040-0000-0000-000004F6E3D4 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0041-0000-0000-00000902FEA3 Message-Id: <20190531061351.22973-88-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 087/110] Remove remnants of OPAL_PCI_GET_PHB_DIAG_DATA X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Never present in a public OPAL release, and only kernels prior to 3.11 would ever attempt to call it. Signed-off-by: Stewart Smith Reviewed-by: Andrew Donnellan --- core/pci-opal.c | 22 ------------------ doc/opal-api/index.rst | 23 ++++++++++++++++++- .../opal-pci-get-phb-diag-data2-64.rst | 11 --------- hw/npu.c | 1 - hw/npu2-opencapi.c | 1 - hw/npu2.c | 1 - hw/p7ioc-phb.c | 1 - hw/phb3.c | 1 - hw/phb4.c | 1 - include/pci.h | 2 -- 10 files changed, 22 insertions(+), 42 deletions(-) diff --git a/core/pci-opal.c b/core/pci-opal.c index 043d9483c026..94afc6df9a8b 100644 --- a/core/pci-opal.c +++ b/core/pci-opal.c @@ -807,28 +807,6 @@ static int64_t opal_pci_set_power_state(uint64_t async_token, } opal_call(OPAL_PCI_SET_POWER_STATE, opal_pci_set_power_state, 3); -static int64_t opal_pci_get_phb_diag_data(uint64_t phb_id, - void *diag_buffer, - uint64_t diag_buffer_len) -{ - struct phb *phb = pci_get_phb(phb_id); - int64_t rc; - - if (!opal_addr_valid(diag_buffer)) - return OPAL_PARAMETER; - - if (!phb) - return OPAL_PARAMETER; - if (!phb->ops->get_diag_data) - return OPAL_UNSUPPORTED; - phb_lock(phb); - rc = phb->ops->get_diag_data(phb, diag_buffer, diag_buffer_len); - phb_unlock(phb); - - return rc; -} -opal_call(OPAL_PCI_GET_PHB_DIAG_DATA, opal_pci_get_phb_diag_data, 3); - static int64_t opal_pci_get_phb_diag_data2(uint64_t phb_id, void *diag_buffer, uint64_t diag_buffer_len) diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index d0e6483fceb1..00ec72f4f74a 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -118,7 +118,10 @@ The OPAL API is the interface between an Operating System and OPAL. +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_GET_HUB_DIAG_DATA` | 50 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_PCI_GET_PHB_DIAG_DATA` | 51 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_PCI_GET_PHB_DIAG_DATA` | 51 | N/A | | Only | +| | | | | implemented | +| | | | | prior to public | +| | | | | release. | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_FENCE_PHB` | 52 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -397,6 +400,10 @@ removed and no longer supported. +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_GET_XIVE_REISSUE` | 36 | Never | | +---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_PCI_GET_PHB_DIAG_DATA` | 51 | pre-v1.0 | pre-v1.0, with last | +| | | | remnants removed in | +| | | | :ref:`skiboot-6.4` | ++---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_GET_XIVE_SOURCE` | 38 | v1.0 Initial Release | :ref:`skiboot-6.4` | +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_WRITE_OPPANEL` | 43 | pre-v1.0 | pre-v1.0 | @@ -457,6 +464,20 @@ A remnant of something prior to OPALv3. Never implemented in skiboot and never used by anyone. Returend :ref:`OPAL_UNSUPPORTED` until :ref:`skiboot-6.4`, where it was removed. +.. _OPAL_PCI_GET_PHB_DIAG_DATA: + +OPAL_PCI_GET_PHB_DIAG_DATA +========================== + +This call was introduced and functionally removed (all backends for it were) +before the first public opal release. It has not been used since Linux 3.11-rc1. +Considering the state of EEH in such old kernels and firmware, removing the +remnants of this call is considered safe. If for some bizarre reason such an +old kernel is run on :ref:`skiboot-6.4` or later, an :ref:`OPAL_PARAMETER` error +will be returned instead of :ref:`OPAL_UNSUPPORTED`. + +It is replaced by :ref:`OPAL_PCI_GET_PHB_DIAG_DATA2` instead. + .. _OPAL_GET_XIVE_SOURCE: OPAL_GET_XIVE_SOURCE diff --git a/doc/opal-api/opal-pci-get-phb-diag-data2-64.rst b/doc/opal-api/opal-pci-get-phb-diag-data2-64.rst index 7a2f98322ea6..ac98bc2a7a45 100644 --- a/doc/opal-api/opal-pci-get-phb-diag-data2-64.rst +++ b/doc/opal-api/opal-pci-get-phb-diag-data2-64.rst @@ -1,14 +1,3 @@ -.. _OPAL_PCI_GET_PHB_DIAG_DATA: - -OPAL_PCI_GET_PHB_DIAG_DATA -========================== - -.. note:: This call is deprecated. It has not been used since Linux 3.11-rc1. - Use :ref:`OPAL_PCI_GET_PHB_DIAG_DATA2` instead. - -.. note:: This call may be removed in the future. - - .. _OPAL_PCI_GET_PHB_DIAG_DATA2: OPAL_PCI_GET_PHB_DIAG_DATA2 diff --git a/hw/npu.c b/hw/npu.c index 2c3f19e51ad1..2de07470989e 100644 --- a/hw/npu.c +++ b/hw/npu.c @@ -1015,7 +1015,6 @@ static const struct phb_ops npu_ops = { .eeh_freeze_set = NULL, .next_error = npu_eeh_next_error, .err_inject = npu_err_inject, - .get_diag_data = NULL, .get_diag_data2 = NULL, .set_capi_mode = NULL, .set_capp_recovery = NULL, diff --git a/hw/npu2-opencapi.c b/hw/npu2-opencapi.c index 7a90cfac40ff..d6d899675f07 100644 --- a/hw/npu2-opencapi.c +++ b/hw/npu2-opencapi.c @@ -1817,7 +1817,6 @@ static const struct phb_ops npu2_opencapi_ops = { .eeh_freeze_set = NULL, .next_error = npu2_opencapi_eeh_next_error, .err_inject = NULL, - .get_diag_data = NULL, .get_diag_data2 = NULL, .set_capi_mode = NULL, .set_capp_recovery = NULL, diff --git a/hw/npu2.c b/hw/npu2.c index 97139dd8baed..b0116e829ec7 100644 --- a/hw/npu2.c +++ b/hw/npu2.c @@ -1385,7 +1385,6 @@ static const struct phb_ops npu_ops = { .eeh_freeze_set = NULL, .next_error = npu2_eeh_next_error, .err_inject = NULL, - .get_diag_data = NULL, .get_diag_data2 = NULL, .set_capi_mode = NULL, .set_capp_recovery = NULL, diff --git a/hw/p7ioc-phb.c b/hw/p7ioc-phb.c index 97730a0be989..ac011039a73b 100644 --- a/hw/p7ioc-phb.c +++ b/hw/p7ioc-phb.c @@ -2304,7 +2304,6 @@ static const struct phb_ops p7ioc_phb_ops = { .eeh_freeze_clear = p7ioc_eeh_freeze_clear, .eeh_freeze_set = p7ioc_eeh_freeze_set, .err_inject = p7ioc_err_inject, - .get_diag_data = NULL, .get_diag_data2 = p7ioc_get_diag_data, .next_error = p7ioc_eeh_next_error, .phb_mmio_enable = p7ioc_phb_mmio_enable, diff --git a/hw/phb3.c b/hw/phb3.c index ee98fd51dd79..3042c3e69cbf 100644 --- a/hw/phb3.c +++ b/hw/phb3.c @@ -3793,7 +3793,6 @@ static const struct phb_ops phb3_ops = { .eeh_freeze_set = phb3_eeh_freeze_set, .next_error = phb3_eeh_next_error, .err_inject = phb3_err_inject, - .get_diag_data = NULL, .get_diag_data2 = phb3_get_diag_data, .set_capi_mode = phb3_set_capi_mode, .set_capp_recovery = phb3_set_capp_recovery, diff --git a/hw/phb4.c b/hw/phb4.c index 3ae96f2eb941..f29729b957ee 100644 --- a/hw/phb4.c +++ b/hw/phb4.c @@ -4797,7 +4797,6 @@ static const struct phb_ops phb4_ops = { .eeh_freeze_set = phb4_eeh_freeze_set, .next_error = phb4_eeh_next_error, .err_inject = phb4_err_inject, - .get_diag_data = NULL, .get_diag_data2 = phb4_get_diag_data, .tce_kill = phb4_tce_kill, .set_capi_mode = phb4_set_capi_mode, diff --git a/include/pci.h b/include/pci.h index b63b1193a806..2b7a3c2893d5 100644 --- a/include/pci.h +++ b/include/pci.h @@ -268,8 +268,6 @@ struct phb_ops { int64_t (*err_inject)(struct phb *phb, uint64_t pe_number, uint32_t type, uint32_t func, uint64_t addr, uint64_t mask); - int64_t (*get_diag_data)(struct phb *phb, void *diag_buffer, - uint64_t diag_buffer_len); int64_t (*get_diag_data2)(struct phb *phb, void *diag_buffer, uint64_t diag_buffer_len); int64_t (*next_error)(struct phb *phb, uint64_t *first_frozen_pe, From patchwork Fri May 31 06:13:29 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108154 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZXk6bv6z9s00 for ; Fri, 31 May 2019 16:38:46 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZXk5DvczDr0T for ; Fri, 31 May 2019 16:38:46 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0R2QQ3zDqYC for ; Fri, 31 May 2019 16:14:15 +1000 (AEST) Received: from pps.filterd (m0098394.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64LHP078733 for ; Fri, 31 May 2019 02:14:12 -0400 Received: from e31.co.us.ibm.com (e31.co.us.ibm.com [32.97.110.149]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stv42d09d-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:11 -0400 Received: from localhost by e31.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:10 +0100 Received: from b03cxnp07029.gho.boulder.ibm.com (9.17.130.16) by e31.co.us.ibm.com (192.168.1.131) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:07 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp07029.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6Bp5112214 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 3AFFF6A051 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 0DD0D6A04D for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 0E6B550CBDD; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:29 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-8235-0000-0000-00000EA0F3AE X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-8236-0000-0000-000045C9C0F4 Message-Id: <20190531061351.22973-89-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=675 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 088/110] doc: OPAL_PCI_FENCE_PHB was never implemented X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/index.rst | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 00ec72f4f74a..5fdd44495cc5 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -123,7 +123,8 @@ The OPAL API is the interface between an Operating System and OPAL. | | | | | prior to public | | | | | | release. | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_PCI_FENCE_PHB` | 52 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_PCI_FENCE_PHB` | 52 | Never | | Never | +| | | | | implemented | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_REINIT` | 53 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -400,6 +401,8 @@ removed and no longer supported. +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_GET_XIVE_REISSUE` | 36 | Never | | +---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_PCI_FENCE_PHB` | 52 | Never | | ++---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_GET_PHB_DIAG_DATA` | 51 | pre-v1.0 | pre-v1.0, with last | | | | | remnants removed in | | | | | :ref:`skiboot-6.4` | @@ -464,6 +467,13 @@ A remnant of something prior to OPALv3. Never implemented in skiboot and never used by anyone. Returend :ref:`OPAL_UNSUPPORTED` until :ref:`skiboot-6.4`, where it was removed. +.. _OPAL_PCI_FENCE_PHB: + +OPAL_PCI_FENCE_PHB +^^^^^^^^^^^^^^^^^^ + +Never implemented. + .. _OPAL_PCI_GET_PHB_DIAG_DATA: OPAL_PCI_GET_PHB_DIAG_DATA From patchwork Fri May 31 06:13:30 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108144 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZTR52Jwz9s00 for ; Fri, 31 May 2019 16:35:55 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZTR2tmYzDql5 for ; Fri, 31 May 2019 16:35:55 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P4htyzDqXt for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098396.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V648G9037916 for ; Fri, 31 May 2019 02:14:10 -0400 Received: from e35.co.us.ibm.com (e35.co.us.ibm.com [32.97.110.153]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4v1d6k-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e35.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:09 +0100 Received: from b03cxnp07029.gho.boulder.ibm.com (9.17.130.16) by e35.co.us.ibm.com (192.168.1.135) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:07 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp07029.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6Zn58654722 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 553716A04D for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 27C1E6A04F for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 1334F50CBDF; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:30 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0012-0000-0000-0000173DDCFF X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0013-0000-0000-00005778F810 Message-Id: <20190531061351.22973-90-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=666 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 089/110] doc: Add skeleton for OPAL_PCI_REINIT X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-reinit-53.rst | 31 +++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 doc/opal-api/opal-pci-reinit-53.rst diff --git a/doc/opal-api/opal-pci-reinit-53.rst b/doc/opal-api/opal-pci-reinit-53.rst new file mode 100644 index 000000000000..677bd2343c9f --- /dev/null +++ b/doc/opal-api/opal-pci-reinit-53.rst @@ -0,0 +1,31 @@ +.. _OPAL_PCI_REINIT: + +OPAL_PCI_REINIT +=============== + +.. code-block:: c + + #define OPAL_PCI_REINIT 53 + + enum OpalPciReinitScope { + /* + * Note: we chose values that do not overlap + * OpalPciResetScope as OPAL v2 used the same + * enum for both + */ + OPAL_REINIT_PCI_DEV = 1000 + }; + + int64_t opal_pci_reinit(uint64_t phb_id, uint64_t reinit_scope, uint64_t data); + +.. note:: Much glory awaits the one who fills in this documentation. + +Returns +------- + +:ref:`OPAL_PARAMETER` + Invalid PHB, scope, or device. +:ref:`OPAL_UNSUPPORTED` + Operation unsupported +:ref:`OPAL_HARDWARE` + Some hardware issue prevented the reinit. From patchwork Fri May 31 06:13:31 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108105 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZJQ2Kkbz9sDX for ; Fri, 31 May 2019 16:28:06 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZJQ0m4zzDqXt for ; Fri, 31 May 2019 16:28:06 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N1KN5zDqY1 for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098404.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64K9u042827 for ; Fri, 31 May 2019 02:14:08 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4vhd6r-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:08 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dxU1006245 for ; Fri, 31 May 2019 02:48:59 GMT Received: from b01cxnp22033.gho.pok.ibm.com (b01cxnp22033.gho.pok.ibm.com [9.57.198.23]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9aykp-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:58 +0000 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp22033.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6k233161386 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 7B713B2067 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 38DC7B205F for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 184FF50CBE2; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:31 +1000 Message-Id: <20190531061351.22973-91-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=867 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 090/110] doc: OPAL_PCI_MASK_PE_ERROR was never implemented X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/index.rst | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 5fdd44495cc5..909b561c469c 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -128,7 +128,8 @@ The OPAL API is the interface between an Operating System and OPAL. +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_REINIT` | 53 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_PCI_MASK_PE_ERROR` | 54 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_PCI_MASK_PE_ERROR` | 54 | Never | | Never | +| | | | | implemented | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_SET_SLOT_LED_STATUS` | 55 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -403,6 +404,8 @@ removed and no longer supported. +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_FENCE_PHB` | 52 | Never | | +---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_PCI_MASK_PE_ERROR` | 54 | Never | | ++---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_GET_PHB_DIAG_DATA` | 51 | pre-v1.0 | pre-v1.0, with last | | | | | remnants removed in | | | | | :ref:`skiboot-6.4` | @@ -474,6 +477,13 @@ OPAL_PCI_FENCE_PHB Never implemented. +.. _OPAL_PCI_MASK_PE_ERROR: + +OPAL_PCI_MASK_PE_ERROR +^^^^^^^^^^^^^^^^^^^^^^ + +Never implemented. + .. _OPAL_PCI_GET_PHB_DIAG_DATA: OPAL_PCI_GET_PHB_DIAG_DATA From patchwork Fri May 31 06:13:32 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108147 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZVC212Wz9s00 for ; Fri, 31 May 2019 16:36:35 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZVC0yF7zDqsq for ; Fri, 31 May 2019 16:36:35 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0Q0r2bzDqYL for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098399.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64CPD137023 for ; Fri, 31 May 2019 02:14:11 -0400 Received: from e34.co.us.ibm.com (e34.co.us.ibm.com [32.97.110.152]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvyfukns-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:11 -0400 Received: from localhost by e34.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:10 +0100 Received: from b03cxnp07028.gho.boulder.ibm.com (9.17.130.15) by e34.co.us.ibm.com (192.168.1.134) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:07 +0100 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp07028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6Em60162138 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 71D29BE05A for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 3B391BE054 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 1C65650CBE5; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:32 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0016-0000-0000-000009BC52A5 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0017-0000-0000-0000436E2D12 Message-Id: <20190531061351.22973-92-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=660 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 091/110] doc: Mark OPAL_SET_SLOT_LED_STATUS as never implemented X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/index.rst | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 909b561c469c..1410ae4e0ac5 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -131,7 +131,8 @@ The OPAL API is the interface between an Operating System and OPAL. | :ref:`OPAL_PCI_MASK_PE_ERROR` | 54 | Never | | Never | | | | | | implemented | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_SET_SLOT_LED_STATUS` | 55 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_SET_SLOT_LED_STATUS` | 55 | Never | | Never | +| | | | | implemented | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_GET_EPOW_STATUS` | 56 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -406,6 +407,8 @@ removed and no longer supported. +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_MASK_PE_ERROR` | 54 | Never | | +---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_SET_SLOT_LED_STATUS` | 55 | Never | | ++---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_GET_PHB_DIAG_DATA` | 51 | pre-v1.0 | pre-v1.0, with last | | | | | remnants removed in | | | | | :ref:`skiboot-6.4` | @@ -484,6 +487,13 @@ OPAL_PCI_MASK_PE_ERROR Never implemented. +.. _OPAL_SET_SLOT_LED_STATUS: + +OPAL_SET_SLOT_LED_STATUS +^^^^^^^^^^^^^^^^^^^^^^^^ + +Never implemented. + .. _OPAL_PCI_GET_PHB_DIAG_DATA: OPAL_PCI_GET_PHB_DIAG_DATA From patchwork Fri May 31 06:13:33 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108141 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZSb4CRsz9s00 for ; Fri, 31 May 2019 16:35:11 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZSb3H5mzDqkb for ; Fri, 31 May 2019 16:35:11 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P2cCSzDqY6 for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098417.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V66AoV145267 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e31.co.us.ibm.com (e31.co.us.ibm.com [32.97.110.149]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvp63v1j-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e31.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b03cxnp07028.gho.boulder.ibm.com (9.17.130.15) by e31.co.us.ibm.com (192.168.1.131) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:07 +0100 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp07028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E63S38076480 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 7982BBE05B for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 429AEBE058 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 2191850CBE8; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:33 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-8235-0000-0000-00000EA0F3B0 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-8236-0000-0000-000045C9C0F5 Message-Id: <20190531061351.22973-93-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 092/110] doc: Add OPAL_GET_EPOW_STATUS docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-get-epow-status-56.rst | 66 ++++++++++++++++++++++++ doc/opal-api/opal-messages.rst | 4 +- 2 files changed, 69 insertions(+), 1 deletion(-) create mode 100644 doc/opal-api/opal-get-epow-status-56.rst diff --git a/doc/opal-api/opal-get-epow-status-56.rst b/doc/opal-api/opal-get-epow-status-56.rst new file mode 100644 index 000000000000..7de7d12c4780 --- /dev/null +++ b/doc/opal-api/opal-get-epow-status-56.rst @@ -0,0 +1,66 @@ +.. _OPAL_GET_EPOW_STATUS: + +OPAL_GET_EPOW_STATUS +==================== + +.. code-block:: c + + #define OPAL_GET_EPOW_STATUS 56 + + enum OpalEpowStatus { + OPAL_EPOW_NONE = 0, + OPAL_EPOW_UPS = 1, + OPAL_EPOW_OVER_AMBIENT_TEMP = 2, + OPAL_EPOW_OVER_INTERNAL_TEMP = 3 + }; + + /* System EPOW type */ + enum OpalSysEpow { + OPAL_SYSEPOW_POWER = 0, /* Power EPOW */ + OPAL_SYSEPOW_TEMP = 1, /* Temperature EPOW */ + OPAL_SYSEPOW_COOLING = 2, /* Cooling EPOW */ + OPAL_SYSEPOW_MAX = 3, /* Max EPOW categories */ + }; + + /* Power EPOW */ + enum OpalSysPower { + OPAL_SYSPOWER_UPS = 0x0001, /* System on UPS power */ + OPAL_SYSPOWER_CHNG = 0x0002, /* System power configuration change */ + OPAL_SYSPOWER_FAIL = 0x0004, /* System impending power failure */ + OPAL_SYSPOWER_INCL = 0x0008, /* System incomplete power */ + }; + + /* Temperature EPOW */ + enum OpalSysTemp { + OPAL_SYSTEMP_AMB = 0x0001, /* System over ambient temperature */ + OPAL_SYSTEMP_INT = 0x0002, /* System over internal temperature */ + OPAL_SYSTEMP_HMD = 0x0004, /* System over ambient humidity */ + }; + + /* Cooling EPOW */ + enum OpalSysCooling { + OPAL_SYSCOOL_INSF = 0x0001, /* System insufficient cooling */ + }; + + int64_t opal_get_epow_status(int16_t *out_epow, int16_t *length); + +The :ref:`OPAL_GET_EPOW_STATUS` call gets the Environmental and Power Warnings +state from OPAL. This can allow an OS to take action based on information from +firmware / sensors. + +On receipt of an :ref:`OPAL_MSG_EPOW` message, the OS can query the status +using the :ref:`OPAL_GET_EPOW_STATUS` call. The OS allocates an array for the +status bits, and passes in the length of this array. OPAL will return the +maximum length it filled out. Thus, new classes can be added and backwards +compatibility is maintained. + +At time of writing, this call is only implemented on FSP based systems. + +Returns +------- + +:ref:`OPAL_SUCCESS` + Successfully retreived status. Note, success is returned even if only + able to retreive a subset of the EPOW classes. + +Other return codes may be returned in the future. diff --git a/doc/opal-api/opal-messages.rst b/doc/opal-api/opal-messages.rst index 54ef340b7173..7843b697c007 100644 --- a/doc/opal-api/opal-messages.rst +++ b/doc/opal-api/opal-messages.rst @@ -42,13 +42,15 @@ Additional parameters are function-specific. OPAL_MSG_MEM_ERR ---------------- +.. _OPAL_MSG_EPOW: + OPAL_MSG_EPOW ------------- Used by OPAL to issue environmental and power warnings to host OS for conditions requiring an earlier poweroff. A few examples of these are high ambient temperature or system running on UPS power with low UPS battery. -Host OS can query OPAL via ``GET_EPOW_STATUS`` API to obtain information about +Host OS can query OPAL via :ref:`OPAL_GET_EPOW_STATUS` API to obtain information about EPOW conditions present. Refer include/opal-api.h for description of all supported EPOW events. OPAL_SYSPOWER_CHNG, OPAL_SYSPOWER_FAIL and OPAL_SYSPOWER_INC events don't require system poweroff. From patchwork Fri May 31 06:13:34 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108114 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZLs3v95z9s00 for ; Fri, 31 May 2019 16:30:13 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZLs2tK8zDqcy for ; Fri, 31 May 2019 16:30:13 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N4pcyzDqZ3 for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098404.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64JTQ042781 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4vhd7c-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dxU3006245 for ; Fri, 31 May 2019 02:48:59 GMT Received: from b03cxnp07028.gho.boulder.ibm.com (b03cxnp07028.gho.boulder.ibm.com [9.17.130.15]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9aykq-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:59 +0000 Received: from b03ledav005.gho.boulder.ibm.com (b03ledav005.gho.boulder.ibm.com [9.17.130.236]) by b03cxnp07028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6lO64880782 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 80363BE05D for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b03ledav005.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 47D59BE04F for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav005.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 26F2350CBEB; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:34 +1000 Message-Id: <20190531061351.22973-94-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=463 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 093/110] doc: OPAL_SET_SYSTEM_ATTENTION_LED was never implemented X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/index.rst | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 1410ae4e0ac5..5aec4e9c4ded 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -136,7 +136,8 @@ The OPAL API is the interface between an Operating System and OPAL. +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_GET_EPOW_STATUS` | 56 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_SET_SYSTEM_ATTENTION_LED` | 57 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_SET_SYSTEM_ATTENTION_LED` | 57 | Never | | Never | +| | | | | implemented | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_RESERVED1` | 58 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -409,6 +410,8 @@ removed and no longer supported. +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_SET_SLOT_LED_STATUS` | 55 | Never | | +---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_SET_SYSTEM_ATTENTION_LED` | 57 | Never | | ++---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_GET_PHB_DIAG_DATA` | 51 | pre-v1.0 | pre-v1.0, with last | | | | | remnants removed in | | | | | :ref:`skiboot-6.4` | @@ -494,6 +497,13 @@ OPAL_SET_SLOT_LED_STATUS Never implemented. +.. _OPAL_SET_SYSTEM_ATTENTION_LED: + +OPAL_SET_SYSTEM_ATTENTION_LED +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Never implemented. + .. _OPAL_PCI_GET_PHB_DIAG_DATA: OPAL_PCI_GET_PHB_DIAG_DATA From patchwork Fri May 31 06:13:35 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108140 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZSM4ZxKz9s00 for ; Fri, 31 May 2019 16:34:59 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZSM3VTTzDqhk for ; Fri, 31 May 2019 16:34:59 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P4KHczDqXW for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098421.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V673UU066676 for ; Fri, 31 May 2019 02:14:10 -0400 Received: from e12.ny.us.ibm.com (e12.ny.us.ibm.com [129.33.205.202]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stxqh877s-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e12.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:09 +0100 Received: from b01cxnp23033.gho.pok.ibm.com (9.57.198.28) by e12.ny.us.ibm.com (146.89.104.199) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:07 +0100 Received: from b01ledav002.gho.pok.ibm.com (b01ledav002.gho.pok.ibm.com [9.57.199.107]) by b01cxnp23033.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6W626345782 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id A12AB124054 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 5E8DD12405A for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav002.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 2BC1350CBEE; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:35 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0060-0000-0000-0000034A56E5 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0061-0000-0000-0000498FD37C Message-Id: <20190531061351.22973-95-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=469 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 094/110] doc: OPAL_RESERVED[12], reserved but never used X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/index.rst | 24 ++++++++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 5aec4e9c4ded..10373d87b6ad 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -139,9 +139,11 @@ The OPAL API is the interface between an Operating System and OPAL. | :ref:`OPAL_SET_SYSTEM_ATTENTION_LED` | 57 | Never | | Never | | | | | | implemented | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_RESERVED1` | 58 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_RESERVED1` | 58 | Never | | Never | +| | | | | implemented | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_RESERVED2` | 59 | v1.0 (Initial Release) | POWER8 | | +| :ref:`OPAL_RESERVED2` | 59 | Never | | Never | +| | | | | implemented | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_NEXT_ERROR` | 60 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -412,6 +414,10 @@ removed and no longer supported. +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_SET_SYSTEM_ATTENTION_LED` | 57 | Never | | +---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_RESERVED1` | 58 | Never | | ++---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_RESERVED2` | 59 | Never | | ++---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_GET_PHB_DIAG_DATA` | 51 | pre-v1.0 | pre-v1.0, with last | | | | | remnants removed in | | | | | :ref:`skiboot-6.4` | @@ -504,6 +510,20 @@ OPAL_SET_SYSTEM_ATTENTION_LED Never implemented. +.. _OPAL_RESERVED1: + +OPAL_RESERVED1 +^^^^^^^^^^^^^^ + +Reserved for future use, but never used. + +.. _OPAL_RESERVED2: + +OPAL_RESERVED2 +^^^^^^^^^^^^^^ + +Reserved for future use, but never used. + .. _OPAL_PCI_GET_PHB_DIAG_DATA: OPAL_PCI_GET_PHB_DIAG_DATA From patchwork Fri May 31 06:13:36 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108152 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZWY3hBxz9s00 for ; Fri, 31 May 2019 16:37:45 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZWX61pKzDr0R for ; Fri, 31 May 2019 16:37:44 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0Q1NwCzDqZn for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098417.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V669dh145241 for ; Fri, 31 May 2019 02:14:10 -0400 Received: from e13.ny.us.ibm.com (e13.ny.us.ibm.com [129.33.205.203]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvp63v1y-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:10 -0400 Received: from localhost by e13.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:09 +0100 Received: from b01cxnp23033.gho.pok.ibm.com (9.57.198.28) by e13.ny.us.ibm.com (146.89.104.200) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:07 +0100 Received: from b01ledav002.gho.pok.ibm.com (b01ledav002.gho.pok.ibm.com [9.57.199.107]) by b01cxnp23033.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6g521496142 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id AA6BD124058 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b01ledav002.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 67DA412405B for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav002.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 30EF150CBF1; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:36 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0064-0000-0000-000003E76F3D X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0065-0000-0000-00003DAD78EB Message-Id: <20190531061351.22973-96-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=794 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 095/110] doc: Add skeleton for OPAL_PCI_NEXT_ERROR X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-next-error-60.rst | 41 +++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 doc/opal-api/opal-pci-next-error-60.rst diff --git a/doc/opal-api/opal-pci-next-error-60.rst b/doc/opal-api/opal-pci-next-error-60.rst new file mode 100644 index 000000000000..1453835b2fdc --- /dev/null +++ b/doc/opal-api/opal-pci-next-error-60.rst @@ -0,0 +1,41 @@ +.. _OPAL_PCI_NEXT_ERROR: + +OPAL_PCI_NEXT_ERROR +=================== + +.. code-block:: c + + #define OPAL_PCI_NEXT_ERROR 60 + + enum OpalPciStatusToken { + OPAL_EEH_NO_ERROR = 0, + OPAL_EEH_IOC_ERROR = 1, + OPAL_EEH_PHB_ERROR = 2, + OPAL_EEH_PE_ERROR = 3, + OPAL_EEH_PE_MMIO_ERROR = 4, + OPAL_EEH_PE_DMA_ERROR = 5 + }; + + enum OpalPciErrorSeverity { + OPAL_EEH_SEV_NO_ERROR = 0, + OPAL_EEH_SEV_IOC_DEAD = 1, + OPAL_EEH_SEV_PHB_DEAD = 2, + OPAL_EEH_SEV_PHB_FENCED = 3, + OPAL_EEH_SEV_PE_ER = 4, + OPAL_EEH_SEV_INF = 5 + }; + + int64_t opal_pci_next_error(uint64_t phb_id, uint64_t *first_frozen_pe, + uint16_t *pci_error_type, uint16_t *severity); + +Retreives details of a PCIe error. + +Returns +------- + +:ref:`OPAL_SUCCESS` + Successfully filled `pci_error_type` and `severity` with error details. +:ref:`OPAL_UNSUPPORTED` + Unsupported operation on this PHB. +:ref:`OPAL_PARAMETER` + Invalid phb_id, or address for other arguments. From patchwork Fri May 31 06:13:37 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108139 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZS80LChz9sDX for ; Fri, 31 May 2019 16:34:48 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZS76BHCzDqgD for ; Fri, 31 May 2019 16:34:47 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P43bRzDqYt for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098419.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V658PG135311 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e31.co.us.ibm.com (e31.co.us.ibm.com [32.97.110.149]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stv224n66-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e31.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:08 +0100 Received: from b03cxnp07028.gho.boulder.ibm.com (9.17.130.15) by e31.co.us.ibm.com (192.168.1.131) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:07 +0100 Received: from b03ledav001.gho.boulder.ibm.com (b03ledav001.gho.boulder.ibm.com [9.17.130.232]) by b03cxnp07028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6fj8323526 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 8FEC46E04E for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 5913C6E04C for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav001.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 3801450CBF3; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:37 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-8235-0000-0000-00000EA0F3AF X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-8236-0000-0000-000045C9C0F6 Message-Id: <20190531061351.22973-97-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=673 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 096/110] doc: Skeleton OPAL_PCI_POLL docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-poll-62.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 doc/opal-api/opal-pci-poll-62.rst diff --git a/doc/opal-api/opal-pci-poll-62.rst b/doc/opal-api/opal-pci-poll-62.rst new file mode 100644 index 000000000000..298aa6d3685d --- /dev/null +++ b/doc/opal-api/opal-pci-poll-62.rst @@ -0,0 +1,18 @@ +.. _OPAL_PCI_POLL: + +OPAL_PCI_POLL +============= + +.. code-block:: c + + #define OPAL_PCI_POLL 62 + + int64_t opal_pci_poll(uint64_t id); + +Crank the state machine for the PHB id. Returns how many milliseconds for +the caller to sleep. + +Returns +------- + +Milliseconds for the caller to sleep for, error code, or :ref:`OPAL_SUCCESS`. From patchwork Fri May 31 06:13:38 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108124 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZNw546Sz9s00 for ; Fri, 31 May 2019 16:32:00 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZNw49TdzDqWb for ; Fri, 31 May 2019 16:32:00 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N5YvzzDqZD for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098414.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V63wI5133745 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stwdwjr2u-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dbKm005901 for ; Fri, 31 May 2019 02:48:59 GMT Received: from b03cxnp07028.gho.boulder.ibm.com (b03cxnp07028.gho.boulder.ibm.com [9.17.130.15]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9aykr-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:59 +0000 Received: from b03ledav001.gho.boulder.ibm.com (b03ledav001.gho.boulder.ibm.com [9.17.130.232]) by b03cxnp07028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E60C45089022 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 95C646E050 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b03ledav001.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 5F0776E053 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav001.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 3A37450CBF6; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:38 +1000 Message-Id: <20190531061351.22973-98-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=729 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 097/110] doc: Add OPAL_PCI_MSI_EOI skeleton docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-msi-eoi-63.rst | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 doc/opal-api/opal-pci-msi-eoi-63.rst diff --git a/doc/opal-api/opal-pci-msi-eoi-63.rst b/doc/opal-api/opal-pci-msi-eoi-63.rst new file mode 100644 index 000000000000..24bdb789d54d --- /dev/null +++ b/doc/opal-api/opal-pci-msi-eoi-63.rst @@ -0,0 +1,24 @@ +.. _OPAL_PCI_MSI_EOI: + +OPAL_PCI_MSI_EOI +================ + +.. code-block:: c + + #define OPAL_PCI_MSI_EOI 63 + + int64_t opal_pci_msi_eoi(uint64_t phb_id, uint32_t hwirq); + +Only required on PHB3 (POWER8) based systems. + +Returns +------- + +:ref:`OPAL_SUCCESS` + Success! +:ref:`OPAL_PARAMETER` + Invalid PHB id or hwirq. +:ref:`OPAL_HARDWARE` + Hardware or configuration issue. +:ref:`OPAL_UNSUPPORTED` + Unsupported on this PHB. From patchwork Fri May 31 06:13:39 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108149 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZVf0fGjz9s00 for ; Fri, 31 May 2019 16:36:58 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZVd6gfXzDqfZ for ; Fri, 31 May 2019 16:36:57 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P5SljzDqZX for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098416.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V644Ec019076 for ; Fri, 31 May 2019 02:14:10 -0400 Received: from e36.co.us.ibm.com (e36.co.us.ibm.com [32.97.110.154]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stty1pngk-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:10 -0400 Received: from localhost by e36.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:09 +0100 Received: from b03cxnp07028.gho.boulder.ibm.com (9.17.130.15) by e36.co.us.ibm.com (192.168.1.136) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:07 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp07028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6Ll26214618 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 967ABC605D for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 5F60FC6059 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 3F22F50CBF8; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:39 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0020-0000-0000-00000EF27382 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0021-0000-0000-000066081EDD Message-Id: <20190531061351.22973-99-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=770 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 098/110] doc: Add OPAL_ELOG_WRITE to a list of future calls X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/index.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index 10373d87b6ad..c6dd0396ccf8 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -636,3 +636,14 @@ and these systems were only ever used with OPAL inside IBM for development and bring-up purposes. Support for p5ioc was removed from the Linux kernel in v4.6-rc1. + + +Future Calls +------------ + +.. _OPAL_ELOG_WRITE: + +OPAL_ELOG_WRITE +^^^^^^^^^^^^^^^ + +May be implemented in the future to complement the :ref:`OPAL_ELOG_READ` call. From patchwork Fri May 31 06:13:40 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108158 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZYZ00Ptz9sND for ; Fri, 31 May 2019 16:39:30 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZYY62txzDr4t for ; Fri, 31 May 2019 16:39:29 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0R6H1TzDqXs for ; Fri, 31 May 2019 16:14:15 +1000 (AEST) Received: from pps.filterd (m0098393.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64AEx075942 for ; Fri, 31 May 2019 02:14:11 -0400 Received: from e16.ny.us.ibm.com (e16.ny.us.ibm.com [129.33.205.206]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stvha4a6h-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:11 -0400 Received: from localhost by e16.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:10 +0100 Received: from b01cxnp23033.gho.pok.ibm.com (9.57.198.28) by e16.ny.us.ibm.com (146.89.104.203) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:07 +0100 Received: from b01ledav001.gho.pok.ibm.com (b01ledav001.gho.pok.ibm.com [9.57.199.106]) by b01cxnp23033.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6of39322048 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id D03D52805E for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 8DC4528059 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav001.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 439C050CBFA; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:40 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0072-0000-0000-00000435AFC6 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0073-0000-0000-00004C6D3D0D Message-Id: <20190531061351.22973-100-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=819 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 099/110] doc: Add skeleton OPAL_RESYNC_TIMEBASE docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-resync-timebase-79.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 doc/opal-api/opal-resync-timebase-79.rst diff --git a/doc/opal-api/opal-resync-timebase-79.rst b/doc/opal-api/opal-resync-timebase-79.rst new file mode 100644 index 000000000000..b4df452e37aa --- /dev/null +++ b/doc/opal-api/opal-resync-timebase-79.rst @@ -0,0 +1,21 @@ +.. _OPAL_RESYNC_TIMEBASE: + +OPAL_RESYNC_TIMEBASE +==================== + +.. code-block:: c + + #define OPAL_RESYNC_TIMEBASE 79 + + int64_t opal_resync_timebase(void); + +Resynchronises the timebase for all threads in a core to the timebase from +chiptod. + +Returns +------- + +:ref:`OPAL_SUCCESS` + Successfully resynced timebases (or it's a no-op on this platform). +:ref:`OPAL_HARDWARE` + Failed to resync timebase. From patchwork Fri May 31 06:13:41 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108118 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZMs1961z9s00 for ; Fri, 31 May 2019 16:31:05 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZMs06y5zDqfX for ; Fri, 31 May 2019 16:31:05 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0N4v2vzDqZB for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098394.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64MuU078805 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stv42d08a-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dbKn005901 for ; Fri, 31 May 2019 02:48:59 GMT Received: from b03cxnp07028.gho.boulder.ibm.com (b03cxnp07028.gho.boulder.ibm.com [9.17.130.15]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9aykt-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:48:59 +0000 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp07028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6T236241580 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B55C5C6061 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 7E14FC6055 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 486E150CBFC; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:41 +1000 Message-Id: <20190531061351.22973-101-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=987 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 100/110] doc: prettify OPAL_GET_MSG X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-get-msg-85.rst | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/doc/opal-api/opal-get-msg-85.rst b/doc/opal-api/opal-get-msg-85.rst index 2cc9307e19d4..a7afc686ca8e 100644 --- a/doc/opal-api/opal-get-msg-85.rst +++ b/doc/opal-api/opal-get-msg-85.rst @@ -1,12 +1,15 @@ +.. _OPAL_GET_MSG: + OPAL_GET_MSG ============ -OPAL_GET_MSG will get the next pending OPAL Message (see :ref:`opal-messages`). +.. code-block:: c + + #define OPAL_GET_MSG 85 -Parameters: :: + int64_t opal_get_msg(uint64_t *buffer, uint64_t size); - buffer to copy message into - sizeof buffer to copy message into +:ref:`OPAL_GET_MSG` will get the next pending OPAL Message (see :ref:`opal-messages`). The maximum size of an opal message is specified in the device tree passed to the host OS: :: @@ -27,14 +30,12 @@ bytes or opal-msg-size. It MUST NOT supply a buffer of < 72 bytes. Return values ------------- -OPAL_RESOURCE +:ref:`OPAL_RESOURCE` no available message. - -OPAL_PARAMETER +:ref:`OPAL_PARAMETER` buffer is NULL or size is < 72 bytes. If buffer size < 72 bytes, the message will NOT be discarded by OPAL. - -OPAL_PARTIAL +:ref:`OPAL_PARTIAL` If pending opal message is greater than supplied buffer. In this case the message is *DISCARDED* by OPAL. This is to keep compatibility with host Operating Systems @@ -42,6 +43,5 @@ OPAL_PARTIAL **NOT CURRENTLY IMPLEMENTED**. Specified so that host OS can prepare for the possible future with either a sensible error message or by gracefully ignoring such OPAL messages. - -OPAL_SUCCESS +:ref:`OPAL_SUCCESS` message successfully copied to buffer. From patchwork Fri May 31 06:13:42 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108133 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZQy2nz9z9s00 for ; Fri, 31 May 2019 16:33:46 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZQy1ndqzDqlg for ; Fri, 31 May 2019 16:33:46 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0P0VhGzDqY0 for ; Fri, 31 May 2019 16:14:12 +1000 (AEST) Received: from pps.filterd (m0098413.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V68YOJ037775 for ; Fri, 31 May 2019 02:14:09 -0400 Received: from e34.co.us.ibm.com (e34.co.us.ibm.com [32.97.110.152]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxr105q3-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:09 -0400 Received: from localhost by e34.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:09 +0100 Received: from b03cxnp07028.gho.boulder.ibm.com (9.17.130.15) by e34.co.us.ibm.com (192.168.1.134) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:07 +0100 Received: from b03ledav006.gho.boulder.ibm.com (b03ledav006.gho.boulder.ibm.com [9.17.130.237]) by b03cxnp07028.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6wD39977168 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:06 GMT Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id BDA76C605A for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b03ledav006.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 86471C6063 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav006.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 4CE4950CBFF; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:42 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0016-0000-0000-000009BC52A6 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0017-0000-0000-0000436E2D13 Message-Id: <20190531061351.22973-102-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=757 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 101/110] doc: prettify OPAL_CHECK_ASYNC_COMPLETION X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-check-async-completion-86.rst | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/doc/opal-api/opal-check-async-completion-86.rst b/doc/opal-api/opal-check-async-completion-86.rst index 9c1505f5acbe..1744c69284bb 100644 --- a/doc/opal-api/opal-check-async-completion-86.rst +++ b/doc/opal-api/opal-check-async-completion-86.rst @@ -1,10 +1,15 @@ +.. _OPAL_CHECK_ASYNC_COMPLETION: + OPAL_CHECK_ASYNC_COMPLETION =========================== -OPAL_CHECK_ASYNC_COMPLETION checks if an async OPAL pending message was completed. (see :ref:`opal-messages`). +:ref:`OPAL_CHECK_ASYNC_COMPLETION` checks if an async OPAL pending message was +completed. (see :ref:`opal-messages`). .. code-block:: c + #define OPAL_CHECK_ASYNC_COMPLETION 86 + int64_t opal_check_completion(uint64_t *buffer, uint64_t size, uint64_t token); Parameters: @@ -16,15 +21,15 @@ size token async message token +Currently unused by Linux, but it is used by FreeBSD. + Return values ------------- -OPAL_PARAMETER +:ref:`OPAL_PARAMETER` buffer parameter is an invalid pointer (NULL or > top of RAM). - -OPAL_SUCCESS +:ref:`OPAL_SUCCESS` message successfully copied to buffer. - -OPAL_BUSY +:ref:`OPAL_BUSY` message is still pending and should be re-checked later. From patchwork Fri May 31 06:13:43 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108176 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZbP0HMFz9s00 for ; Fri, 31 May 2019 16:41:05 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZbN6Y7bzDr7m for ; Fri, 31 May 2019 16:41:04 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ1p1sqzzDqYC for ; Fri, 31 May 2019 16:15:26 +1000 (AEST) Received: from pps.filterd (m0098419.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V6575F135250 for ; Fri, 31 May 2019 02:15:23 -0400 Received: from ppma01dal.us.ibm.com (83.d6.3fa9.ip4.static.sl-reverse.com [169.63.214.131]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stv224p8p-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:15:23 -0400 Received: from pps.filterd (ppma01dal.us.ibm.com [127.0.0.1]) by ppma01dal.us.ibm.com (8.16.0.27/8.16.0.27) with SMTP id x4V2dm0R006006 for ; Fri, 31 May 2019 02:50:06 GMT Received: from b01cxnp23034.gho.pok.ibm.com (b01cxnp23034.gho.pok.ibm.com [9.57.198.29]) by ppma01dal.us.ibm.com with ESMTP id 2spwb9aysx-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:50:06 +0000 Received: from b01ledav004.gho.pok.ibm.com (b01ledav004.gho.pok.ibm.com [9.57.199.109]) by b01cxnp23034.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6k933030468 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:07 GMT Received: from b01ledav004.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id DF701112062 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b01ledav004.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 9CD4F112061 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav004.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 5105A50CC02; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:43 +1000 Message-Id: <20190531061351.22973-103-stewart@linux.ibm.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 102/110] doc: prettify OPAL_SYNC_HOST_REBOOT X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-sync-host-reboot-87.rst | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/doc/opal-api/opal-sync-host-reboot-87.rst b/doc/opal-api/opal-sync-host-reboot-87.rst index 466e673c9664..bc5605d31f30 100644 --- a/doc/opal-api/opal-sync-host-reboot-87.rst +++ b/doc/opal-api/opal-sync-host-reboot-87.rst @@ -1,22 +1,25 @@ +.. _OPAL_SYNC_HOST_REBOOT: + OPAL_SYNC_HOST_REBOOT ===================== -:: - static int64_t opal_sync_host_reboot(void) +.. code-block:: c + + #define OPAL_SYNC_HOST_REBOOT 87 + + static int64_t opal_sync_host_reboot(void); This OPAL call halts asynchronous operations in preparation for something like kexec. It will halt DMA as well notification of some events (such as a new error log being available for retreival). -It's meant to be called in a loop until OPAL_SUCCESS is returned. +It's meant to be called in a loop until :ref:`OPAL_SUCCESS` is returned. Returns ------- -OPAL_SUCCESS +:ref:`OPAL_SUCCESS` Success! - -OPAL_BUSY_EVENT +:ref:`OPAL_BUSY_EVENT` not yet complete, call opal_sync_host_reboot() again, possibly with a short delay. - -OPAL_BUSY +:ref:`OPAL_BUSY` Call opal_poll_events() and then retry opal_sync_host_reboot From patchwork Fri May 31 06:13:44 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108166 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZZS1K0Zz9sMM for ; Fri, 31 May 2019 16:40:16 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZZS0Q1jzDr7P for ; Fri, 31 May 2019 16:40:16 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0S22WVzDqYM for ; Fri, 31 May 2019 16:14:16 +1000 (AEST) Received: from pps.filterd (m0098420.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V6AtwE086634 for ; Fri, 31 May 2019 02:14:12 -0400 Received: from e36.co.us.ibm.com (e36.co.us.ibm.com [32.97.110.154]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxsbg1uv-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:11 -0400 Received: from localhost by e36.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:11 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e36.co.us.ibm.com (192.168.1.136) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:08 +0100 Received: from b03ledav002.gho.boulder.ibm.com (b03ledav002.gho.boulder.ibm.com [9.17.130.233]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E7aS19530062 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:07 GMT Received: from b03ledav002.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 0C9FF136053 for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: from b03ledav002.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 9D3D913604F for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav002.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 5644650CC05; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:44 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0020-0000-0000-00000EF27383 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:09 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0021-0000-0000-000066081EDF Message-Id: <20190531061351.22973-104-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=3 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 103/110] doc: Document OPAL_GET_PARAM and OPAL_SET_PARAM X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/device-tree/ibm,opal/sysparams.rst | 38 ++++++++++++ doc/opal-api/opal-param-89-90.rst | 84 ++++++++++++++++++++++++++ 2 files changed, 122 insertions(+) create mode 100644 doc/device-tree/ibm,opal/sysparams.rst create mode 100644 doc/opal-api/opal-param-89-90.rst diff --git a/doc/device-tree/ibm,opal/sysparams.rst b/doc/device-tree/ibm,opal/sysparams.rst new file mode 100644 index 000000000000..8b74650db1ad --- /dev/null +++ b/doc/device-tree/ibm,opal/sysparams.rst @@ -0,0 +1,38 @@ +.. _device-tree/ibm,opal/sysparams: + +sysparams +========= + +.. code-block:: c + + /* System parameter permission */ + enum OpalSysparamPerm { + OPAL_SYSPARAM_READ = 0x1, + OPAL_SYSPARAM_WRITE = 0x2, + OPAL_SYSPARAM_RW = (OPAL_SYSPARAM_READ | OPAL_SYSPARAM_WRITE), + }; + + +.. code-block:: dts + + sysparams { + compatible = "ibm,opal-sysparams"; + param-id = <0xf0000001 0xf0000003 0xf0000012 0xf0000016 0xf000001d 0xf0000023 0xf0000024 0xf0000025 0xf0000026 0xf0000027>; + param-name = "surveillance", "hmc-management", "cupd-policy", "plat-hmc-managed", "fw-license-policy", "world-wide-port-num", "default-boot-device", "next-boot-device", "console-select", "boot-device-path"; + param-perm = [03 01 03 03 03 02 03 03 03 03]; + phandle = <0x10000032>; + param-len = <0x4 0x4 0x4 0x4 0x4 0xc 0x1 0x1 0x1 0x30>; + linux,phandle = <0x10000032>; + }; + +Device tree node for system parameters accessible through the +:ref:`opal-sysparams` calls :ref:`OPAL_GET_PARAM` and :ref:`OPAL_SET_PARAM`. + +While many systems and platforms will support parameters and configuration via +either nvram or over IPMI, some platforms may have parameters that need to be +set a different way. + +Some parameters may be set Read Only, so the `param-perm` property indicates +permissions. + +Currently, this is only something that exists on FSP based systems. diff --git a/doc/opal-api/opal-param-89-90.rst b/doc/opal-api/opal-param-89-90.rst new file mode 100644 index 000000000000..1d1cedaf6e33 --- /dev/null +++ b/doc/opal-api/opal-param-89-90.rst @@ -0,0 +1,84 @@ +.. _opal-sysparams: + +========================= +Get/Set System Parameters +========================= + +The usual way for setting system parameters is via IPMI for things controlled +by the service processor, or through NVRAM for things controlled by host +firmware. However, some platforms may have other options not easily (or +possible to be) exposed over IPMI. These OPAL calls will read (and write) +these parameters. + +The list of parameters is set at boot time, and is represented in the device +tree (see :ref:`device-tree/ibm,opal/sysparams` for details). + +Currently only implemented on FSP based systems. + +.. _OPAL_GET_PARAM: + +OPAL_GET_PARAM +============== + +.. code-block:: c + + #define OPAL_GET_PARAM 89 + + int64_t fsp_opal_get_param(uint64_t async_token, uint32_t param_id, + uint64_t buffer, uint64_t length); + +Get the current setting of `param_id`. This is an asynchronous call as OPAL may +need to communicate with a service processor. The `param_id` and `length` are +described in the device tree for each parameter (see +:ref:`device-tree/ibm,opal/sysparams` for details). + +Returns +------- +:ref:`OPAL_HARDWARE` + Hardware issue prevents retreiving parameter. e.g. FSP is offline or + absent. +:ref:`OPAL_PARAMETER` + Invalid `param_id` +:ref:`OPAL_PERMISSION` + Not allowed to read parameter. +:ref:`OPAL_NO_MEM` + Not enough free memory in OPAL to process request. +:ref:`OPAL_INTERNAL_ERROR` + Other internal OPAL error +:ref:`OPAL_ASYNC_COMPLETION` + Request is submitted. + +.. _OPAL_SET_PARAM: + +OPAL_SET_PARAM +============== + +.. code-block:: c + + #define OPAL_SET_PARAM 90 + + int64_t fsp_opal_set_param(uint64_t async_token, uint32_t param_id, + uint64_t buffer, uint64_t length); + + +Write a new setting for `param_id`. This is an asynchronous call as OPAL may +need to communicate with a service processor. The `param_id` and `length` are +described in the device tree for each parameter (see +:ref:`device-tree/ibm,opal/sysparams` for details). + + +Returns +------- +:ref:`OPAL_HARDWARE` + Hardware issue prevents retreiving parameter. e.g. FSP is offline or + absent. +:ref:`OPAL_PARAMETER` + Invalid `param_id` +:ref:`OPAL_PERMISSION` + Not allowed to write parameter. +:ref:`OPAL_NO_MEM` + Not enough free memory in OPAL to process request. +:ref:`OPAL_INTERNAL_ERROR` + Other internal OPAL error +:ref:`OPAL_ASYNC_COMPLETION` + Request is submitted. From patchwork Fri May 31 06:13:45 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108145 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZTl3Vy7z9s00 for ; Fri, 31 May 2019 16:36:11 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZTl2VFnzDql2 for ; Fri, 31 May 2019 16:36:11 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0Q1Nk5zDqZb for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098394.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64IdM078439 for ; Fri, 31 May 2019 02:14:11 -0400 Received: from e33.co.us.ibm.com (e33.co.us.ibm.com [32.97.110.151]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stv42d099-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:10 -0400 Received: from localhost by e33.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:10 +0100 Received: from b03cxnp07029.gho.boulder.ibm.com (9.17.130.16) by e33.co.us.ibm.com (192.168.1.133) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:07 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp07029.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E6cg36503616 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:07 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id E24716A057 for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id AAEC76A04F for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 5A7CC50CC08; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:45 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0036-0000-0000-00000AC51853 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:08 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0037-0000-0000-00004C021483 Message-Id: <20190531061351.22973-105-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=550 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 104/110] doc: Document OPAL_ELOG_SEND as not ever used X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/index.rst | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/doc/opal-api/index.rst b/doc/opal-api/index.rst index c6dd0396ccf8..6a78ec034ed1 100644 --- a/doc/opal-api/index.rst +++ b/doc/opal-api/index.rst @@ -211,7 +211,7 @@ The OPAL API is the interface between an Operating System and OPAL. +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_DUMP_RESEND` | 91 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ -| :ref:`OPAL_ELOG_SEND` | 92 | v1.0 (Initial Release) | POWER8 | Deprecated | +| :ref:`OPAL_ELOG_SEND` | 92 | Never | | Never used | +---------------------------------------------+--------------+------------------------+----------+-----------------+ | :ref:`OPAL_PCI_SET_PHB_CAPI_MODE` | 93 | v1.0 (Initial Release) | POWER8 | | +---------------------------------------------+--------------+------------------------+----------+-----------------+ @@ -418,6 +418,8 @@ removed and no longer supported. +---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_RESERVED2` | 59 | Never | | +---------------------------------------------+-------+-----------------------+-----------------------+ +| :ref:`OPAL_ELOG_SEND` | 92 | pre-v1.0 | pre-v1.0 | ++---------------------------------------------+-------+-----------------------+-----------------------+ | :ref:`OPAL_PCI_GET_PHB_DIAG_DATA` | 51 | pre-v1.0 | pre-v1.0, with last | | | | | remnants removed in | | | | | :ref:`skiboot-6.4` | @@ -524,6 +526,15 @@ OPAL_RESERVED2 Reserved for future use, but never used. +.. _OPAL_ELOG_SEND: + +OPAL_ELOG_SEND +^^^^^^^^^^^^^^ + +Brielfy present prior to the first public release of OPAL. Never used in any +public kernel tree. If this functionality were to ever be implemented, it'd +appear as :ref:`OPAL_ELOG_WRITE` rather than this call. + .. _OPAL_PCI_GET_PHB_DIAG_DATA: OPAL_PCI_GET_PHB_DIAG_DATA From patchwork Fri May 31 06:13:46 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108153 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZXR69lNz9sNC for ; Fri, 31 May 2019 16:38:31 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZXR2DvlzDr2d for ; Fri, 31 May 2019 16:38:31 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0R0h99zDqY2 for ; Fri, 31 May 2019 16:14:14 +1000 (AEST) Received: from pps.filterd (m0098394.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64JhN078533 for ; Fri, 31 May 2019 02:14:11 -0400 Received: from e32.co.us.ibm.com (e32.co.us.ibm.com [32.97.110.150]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stv42d09m-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:11 -0400 Received: from localhost by e32.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:10 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e32.co.us.ibm.com (192.168.1.132) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:08 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E77725559372 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:07 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 3657A6A047 for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id F2E0F6A04D for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:06 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 5FA5550CC0B; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:46 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0004-0000-0000-0000151674FF X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:09 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0005-0000-0000-00008BDE97AC Message-Id: <20190531061351.22973-106-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=3 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=492 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 105/110] doc: Document OPAL_WRITE_OPPANEL_ASYNC X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/device-tree/ibm,opal/oppanel.rst | 2 + doc/opal-api/opal-write-oppanel-async-95.rst | 49 ++++++++++++++++++++ 2 files changed, 51 insertions(+) create mode 100644 doc/opal-api/opal-write-oppanel-async-95.rst diff --git a/doc/device-tree/ibm,opal/oppanel.rst b/doc/device-tree/ibm,opal/oppanel.rst index fd02e9bb722b..c13949f823aa 100644 --- a/doc/device-tree/ibm,opal/oppanel.rst +++ b/doc/device-tree/ibm,opal/oppanel.rst @@ -1,3 +1,5 @@ +.. _device-tree/ibm,opal/oppanel: + Operator Panel (oppanel) ======================== diff --git a/doc/opal-api/opal-write-oppanel-async-95.rst b/doc/opal-api/opal-write-oppanel-async-95.rst new file mode 100644 index 000000000000..6a3d738861e3 --- /dev/null +++ b/doc/opal-api/opal-write-oppanel-async-95.rst @@ -0,0 +1,49 @@ +.. _OPAL_WRITE_OPPANEL_ASYNC: + +OPAL_WRITE_OPPANEL_ASYNC +======================== + +.. code-block:: c + + #define OPAL_WRITE_OPPANEL_ASYNC 95 + + typedef struct oppanel_line { + __be64 line; + __be64 line_len; + } oppanel_line_t; + + int64_t opal_write_oppanel_async(uint64_t async_token, + oppanel_line_t *lines, + uint64_t num_lines); + +Writes to a (possibly physical) Operator Panel. An Operator Panel contains +a small LCD screen (or similar) displaying a small amount of ASCII text. +It can be used to report on boot progress, failure, or witty messages from +a systems administrator. + +A typical panel, as present on IBM FSP based machines, is two lines of 16 +characters each. + +See :ref:`device-tree/ibm,opal/oppanel` for how the panel is described in the +device tree. Not all systems have an operator panel. + +Pass in an array of oppanel_line_t structs defining the ASCII characters +to display on each line of the oppanel. If there are two lines on the +physical panel, and you only want to write to the first line, you only +need to pass in one line. If you only want to write to the second line, +you need to pass in both lines, and set the line_len of the first line +to zero. + +Returns +------- +:ref:`OPAL_SUCCESS` + Success! Typically this is async operation, so immediate success is + unlikely. +:ref:`OPAL_ASYNC_COMPLETION` + Request submitted asynchronously. +:ref:`OPAL_PARAMETER` + Invalid `lines` or `num_lines` +:ref:`OPAL_NO_MEM` + Not enough free memory in OPAL to complete the request. +:ref:`OPAL_INTERNAL_ERROR` + Other internal error. From patchwork Fri May 31 06:13:47 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108178 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZbs0h54z9s00 for ; Fri, 31 May 2019 16:41:29 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZbr6rNhzDrDN for ; Fri, 31 May 2019 16:41:28 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ1q3QkszDqYB for ; Fri, 31 May 2019 16:15:27 +1000 (AEST) Received: from pps.filterd (m0098410.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V6461m140851 for ; Fri, 31 May 2019 02:15:25 -0400 Received: from e11.ny.us.ibm.com (e11.ny.us.ibm.com [129.33.205.201]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4vsbej-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:15:25 -0400 Received: from localhost by e11.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:15:24 +0100 Received: from b01cxnp23034.gho.pok.ibm.com (9.57.198.29) by e11.ny.us.ibm.com (146.89.104.198) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:15:23 +0100 Received: from b01ledav001.gho.pok.ibm.com (b01ledav001.gho.pok.ibm.com [9.57.199.106]) by b01cxnp23034.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E7Kj20840886 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:07 GMT Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 72B562805A for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 306CD28059 for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav001.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 64F5450CC0D; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:47 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-2213-0000-0000-0000039856C9 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992125; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:15:23 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-2214-0000-0000-00005EA4D9D9 Message-Id: <20190531061351.22973-107-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=882 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 106/110] doc: Skeleton OPAL_PCI_ERR_INJECT docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-err-inject-96.rst | 54 +++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 doc/opal-api/opal-pci-err-inject-96.rst diff --git a/doc/opal-api/opal-pci-err-inject-96.rst b/doc/opal-api/opal-pci-err-inject-96.rst new file mode 100644 index 000000000000..0820e9001615 --- /dev/null +++ b/doc/opal-api/opal-pci-err-inject-96.rst @@ -0,0 +1,54 @@ +.. _OPAL_PCI_ERR_INJECT: + +OPAL_PCI_ERR_INJECT +=================== + +.. code-block:: c + + #define OPAL_PCI_ERR_INJECT 96 + + enum OpalErrinjectType { + OPAL_ERR_INJECT_TYPE_IOA_BUS_ERR = 0, + OPAL_ERR_INJECT_TYPE_IOA_BUS_ERR64 = 1, + }; + + enum OpalErrinjectFunc { + /* IOA bus specific errors */ + OPAL_ERR_INJECT_FUNC_IOA_LD_MEM_ADDR = 0, + OPAL_ERR_INJECT_FUNC_IOA_LD_MEM_DATA = 1, + OPAL_ERR_INJECT_FUNC_IOA_LD_IO_ADDR = 2, + OPAL_ERR_INJECT_FUNC_IOA_LD_IO_DATA = 3, + OPAL_ERR_INJECT_FUNC_IOA_LD_CFG_ADDR = 4, + OPAL_ERR_INJECT_FUNC_IOA_LD_CFG_DATA = 5, + OPAL_ERR_INJECT_FUNC_IOA_ST_MEM_ADDR = 6, + OPAL_ERR_INJECT_FUNC_IOA_ST_MEM_DATA = 7, + OPAL_ERR_INJECT_FUNC_IOA_ST_IO_ADDR = 8, + OPAL_ERR_INJECT_FUNC_IOA_ST_IO_DATA = 9, + OPAL_ERR_INJECT_FUNC_IOA_ST_CFG_ADDR = 10, + OPAL_ERR_INJECT_FUNC_IOA_ST_CFG_DATA = 11, + OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_ADDR = 12, + OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_DATA = 13, + OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_MASTER = 14, + OPAL_ERR_INJECT_FUNC_IOA_DMA_RD_TARGET = 15, + OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_ADDR = 16, + OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_DATA = 17, + OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_MASTER = 18, + OPAL_ERR_INJECT_FUNC_IOA_DMA_WR_TARGET = 19, + }; + + int64_t opal_pci_err_inject(uint64_t phb_id, uint64_t pe_number, + uint32_t type, uint32_t func, + uint64_t addr, uint64_t mask); + +Inject an error, used to test OS and OPAL EEH handling. + +Returns +------- + +:ref:`OPAL_SUCCESS` + Error injected successfully. +:ref:`OPAL_PARAMETER` + Invalid argument. +:ref:`OPAL_UNSUPPORTED` + PHB doesn't support error injection or the specific error attempting to + be injected. From patchwork Fri May 31 06:13:48 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108151 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZWC5VJ4z9sNp for ; Fri, 31 May 2019 16:37:27 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZWC19BHzDqyg for ; Fri, 31 May 2019 16:37:27 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0Q3FMSzDqZq for ; Fri, 31 May 2019 16:14:14 +1000 (AEST) Received: from pps.filterd (m0098396.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V642cI037659 for ; Fri, 31 May 2019 02:14:11 -0400 Received: from e16.ny.us.ibm.com (e16.ny.us.ibm.com [129.33.205.206]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4v1d6w-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:11 -0400 Received: from localhost by e16.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:10 +0100 Received: from b01cxnp23034.gho.pok.ibm.com (9.57.198.29) by e16.ny.us.ibm.com (146.89.104.203) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:08 +0100 Received: from b01ledav001.gho.pok.ibm.com (b01ledav001.gho.pok.ibm.com [9.57.199.106]) by b01cxnp23034.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E7gC34210282 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:07 GMT Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 8EC8628059 for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: from b01ledav001.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 4C4D728060 for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav001.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 695D850CC0F; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:48 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0072-0000-0000-00000435AFC7 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:09 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0073-0000-0000-00004C6D3D0E Message-Id: <20190531061351.22973-108-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=728 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 107/110] doc: skeleton OPAL_PCI_EEH_FREEZE_SET docs X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-eeh-freeze-set-97.rst | 29 +++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 doc/opal-api/opal-pci-eeh-freeze-set-97.rst diff --git a/doc/opal-api/opal-pci-eeh-freeze-set-97.rst b/doc/opal-api/opal-pci-eeh-freeze-set-97.rst new file mode 100644 index 000000000000..b601ef689aff --- /dev/null +++ b/doc/opal-api/opal-pci-eeh-freeze-set-97.rst @@ -0,0 +1,29 @@ +.. _OPAL_PCI_EEH_FREEZE_SET: + +OPAL_PCI_EEH_FREEZE_SET +======================= + +.. code-block:: c + + #define OPAL_PCI_EEH_FREEZE_SET 97 + + enum OpalEehFreezeActionToken { + OPAL_EEH_ACTION_CLEAR_FREEZE_MMIO = 1, + OPAL_EEH_ACTION_CLEAR_FREEZE_DMA = 2, + OPAL_EEH_ACTION_CLEAR_FREEZE_ALL = 3, + + OPAL_EEH_ACTION_SET_FREEZE_MMIO = 1, + OPAL_EEH_ACTION_SET_FREEZE_DMA = 2, + OPAL_EEH_ACTION_SET_FREEZE_ALL = 3 + }; + + int64_t opal_pci_eeh_freeze_set(uint64_t phb_id, uint64_t pe_number, uint64_t eeh_action_token); + +Returns +------- +:ref:`OPAL_PARAMETER` + Invalid parameter. +:ref:`OPAL_UNSUPPORTED` + Unsupported operation +:ref:`OPAL_HARDWARE` + Hardware in a bad state. From patchwork Fri May 31 06:13:49 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108161 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZYy5mmLz9sDX for ; Fri, 31 May 2019 16:39:50 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZYy4yC8zDr6Y for ; Fri, 31 May 2019 16:39:50 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0S3YDFzDqYX for ; Fri, 31 May 2019 16:14:16 +1000 (AEST) Received: from pps.filterd (m0098404.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V64J52042772 for ; Fri, 31 May 2019 02:14:12 -0400 Received: from e13.ny.us.ibm.com (e13.ny.us.ibm.com [129.33.205.203]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stx4vhd8j-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:12 -0400 Received: from localhost by e13.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:11 +0100 Received: from b01cxnp22034.gho.pok.ibm.com (9.57.198.24) by e13.ny.us.ibm.com (146.89.104.200) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:08 +0100 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp22034.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E7fj34930882 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:07 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 9BB10B2065 for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 58A16B205F for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 6DC6750CC11; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:49 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0064-0000-0000-000003E76F3E X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636340; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:09 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0065-0000-0000-00003DAD78ED Message-Id: <20190531061351.22973-109-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=792 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 108/110] doc: Document OPAL_CONFIG_CPU_IDLE_STATE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- .../opal-config-cpu-idle-state-99.rst | 32 +++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 doc/opal-api/opal-config-cpu-idle-state-99.rst diff --git a/doc/opal-api/opal-config-cpu-idle-state-99.rst b/doc/opal-api/opal-config-cpu-idle-state-99.rst new file mode 100644 index 000000000000..787d2cae9067 --- /dev/null +++ b/doc/opal-api/opal-config-cpu-idle-state-99.rst @@ -0,0 +1,32 @@ +.. _OPAL_CONFIG_CPU_IDLE_STATE: + +OPAL_CONFIG_CPU_IDLE_STATE +========================== + +.. code-block:: c + + #define OPAL_CONFIG_CPU_IDLE_STATE 99 + + /* + * Setup and cleanup method for fast-sleep workarounds + * state = 1 fast-sleep + * enter = 1 Enter state + * exit = 0 Exit state + */ + + #define OPAL_PM_SLEEP_ENABLED_ER1 0x00080000 /* with workaround */ + + int64_t opal_config_cpu_idle_state(uint64_t state, uint64_t enter); + +If the `OPAL_PM_SLEEP_ENABLED_ER1` bit is set on a stop state, then this OPAL +call needs to be made upon entry and exit of stop state. +This is currently needed for the `fastsleep_` idle state, present on POWER8 +systems. + +Returns +------- + +:ref:`OPAL_SUCCESS` + Applied workaround +:ref:`OPAL_PARAMETER` + Invalid state or enter/exit. From patchwork Fri May 31 06:13:50 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108155 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZYC08Wlz9s00 for ; Fri, 31 May 2019 16:39:11 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZYB6Db4zDqkx for ; Fri, 31 May 2019 16:39:10 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0R74w8zDqY1 for ; Fri, 31 May 2019 16:14:15 +1000 (AEST) Received: from pps.filterd (m0098421.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V6741U066722 for ; Fri, 31 May 2019 02:14:11 -0400 Received: from e31.co.us.ibm.com (e31.co.us.ibm.com [32.97.110.149]) by mx0a-001b2d01.pphosted.com with ESMTP id 2stxqh878k-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:11 -0400 Received: from localhost by e31.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:10 +0100 Received: from b03cxnp08025.gho.boulder.ibm.com (9.17.130.17) by e31.co.us.ibm.com (192.168.1.131) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:08 +0100 Received: from b03ledav003.gho.boulder.ibm.com (b03ledav003.gho.boulder.ibm.com [9.17.130.234]) by b03cxnp08025.gho.boulder.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E7rm28770798 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:07 GMT Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 85DBE6A047 for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: from b03ledav003.gho.boulder.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 4F0786A064 for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b03ledav003.gho.boulder.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 7280350CC14; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:50 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-8235-0000-0000-00000EA0F3B1 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:09 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-8236-0000-0000-000045C9C0F8 Message-Id: <20190531061351.22973-110-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=742 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 109/110] doc: prettify OPAL_GET_XIVE and OPAL_SET_XIVE X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-get-xive-20.rst | 9 +++++++-- doc/opal-api/opal-set-xive-19.rst | 7 ++++++- 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/doc/opal-api/opal-get-xive-20.rst b/doc/opal-api/opal-get-xive-20.rst index 65f4b0e5dfaf..cdca1fcb65ea 100644 --- a/doc/opal-api/opal-get-xive-20.rst +++ b/doc/opal-api/opal-get-xive-20.rst @@ -1,11 +1,16 @@ +.. _OPAL_GET_XIVE: + OPAL_GET_XIVE ============= -:: + +.. code-block:: c #define OPAL_GET_XIVE 20 + int64_t opal_get_xive(uint32_t isn, uint16_t *server, uint8_t *priority); + The host calls this function to return the configuration of an -interrupt source. See OPAL_SET_XIVE for details. +interrupt source. See :ref:`OPAL_SET_XIVE` for details. Parameters ---------- diff --git a/doc/opal-api/opal-set-xive-19.rst b/doc/opal-api/opal-set-xive-19.rst index f301e5e5fac3..2a7332f0370a 100644 --- a/doc/opal-api/opal-set-xive-19.rst +++ b/doc/opal-api/opal-set-xive-19.rst @@ -1,9 +1,14 @@ +.. _OPAL_SET_XIVE: + OPAL_SET_XIVE ============= -:: + +.. code-block:: c #define OPAL_SET_XIVE 19 + int64_t opal_set_xive(uint32_t isn, uint16_t server, uint8_t priority); + The host calls this function to set the server (target processor) and priority parameters of an interrupt source. From patchwork Fri May 31 06:13:51 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stewart Smith X-Patchwork-Id: 1108150 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45FZVy3Yssz9sN6 for ; Fri, 31 May 2019 16:37:14 +1000 (AEST) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45FZVy1M4bzDqwT for ; Fri, 31 May 2019 16:37:14 +1000 (AEST) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=linux.ibm.com (client-ip=148.163.158.5; helo=mx0a-001b2d01.pphosted.com; envelope-from=stewart@linux.ibm.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45FZ0Q1Np2zDqZl for ; Fri, 31 May 2019 16:14:13 +1000 (AEST) Received: from pps.filterd (m0098420.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x4V6AwEh086819 for ; Fri, 31 May 2019 02:14:10 -0400 Received: from e17.ny.us.ibm.com (e17.ny.us.ibm.com [129.33.205.207]) by mx0b-001b2d01.pphosted.com with ESMTP id 2stxsbg1uh-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 31 May 2019 02:14:10 -0400 Received: from localhost by e17.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 31 May 2019 07:14:09 +0100 Received: from b01cxnp22034.gho.pok.ibm.com (9.57.198.24) by e17.ny.us.ibm.com (146.89.104.204) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 31 May 2019 07:14:08 +0100 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp22034.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x4V6E7kJ23134434 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 31 May 2019 06:14:07 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id AB015B205F for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 67FFFB2064 for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: from birb.localdomain (unknown [9.185.142.91]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP for ; Fri, 31 May 2019 06:14:07 +0000 (GMT) Received: by birb.localdomain (Postfix, from userid 1000) id 76E7750CC17; Fri, 31 May 2019 16:13:58 +1000 (AEST) From: Stewart Smith To: skiboot@lists.ozlabs.org Date: Fri, 31 May 2019 16:13:51 +1000 X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190531061351.22973-1-stewart@linux.ibm.com> References: <20190531061351.22973-1-stewart@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 19053106-0040-0000-0000-000004F6E3D5 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00011189; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000286; SDB=6.01211088; UDB=6.00636341; IPR=6.00992124; MB=3.00027126; MTD=3.00000008; XFM=3.00000015; UTC=2019-05-31 06:14:09 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19053106-0041-0000-0000-00000902FEA4 Message-Id: <20190531061351.22973-111-stewart@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-31_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1905310040 Subject: [Skiboot] [PATCH 110/110] doc: fixup misc broken links X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-get-set-pbcq-tunnel-bar-164-165.rst | 4 ++-- doc/opal-api/opal-poll-events.rst | 1 + doc/release-notes/skiboot-5.10-rc1.rst | 2 +- doc/release-notes/skiboot-5.10.rst | 2 +- 4 files changed, 5 insertions(+), 4 deletions(-) diff --git a/doc/opal-api/opal-pci-get-set-pbcq-tunnel-bar-164-165.rst b/doc/opal-api/opal-pci-get-set-pbcq-tunnel-bar-164-165.rst index 87a2c7decdf1..dcbd62e31d5b 100644 --- a/doc/opal-api/opal-pci-get-set-pbcq-tunnel-bar-164-165.rst +++ b/doc/opal-api/opal-pci-get-set-pbcq-tunnel-bar-164-165.rst @@ -48,10 +48,10 @@ The host calls this function to set the PBCQ Tunnel Bar register. Parameters ---------- -:ref:``phb_id` +`phb_id` The value from the PHB node ibm,opal-phbid property for the device. -:ref:`addr` +`addr` The value of the address chosen for the PBCQ Tunnel Bar register. If the address is 0, then the PBCQ Tunnel Bar register will be reset. It the address is non-zero, then the PBCQ Tunnel Bar register will be diff --git a/doc/opal-api/opal-poll-events.rst b/doc/opal-api/opal-poll-events.rst index c4bf24dcd8d1..bcf218a51058 100644 --- a/doc/opal-api/opal-poll-events.rst +++ b/doc/opal-api/opal-poll-events.rst @@ -18,6 +18,7 @@ OPAL_EVENT_NVRAM = 0x2 ---------------------- Unused +.. _OPAL_EVENT_RTC: OPAL_EVENT_RTC = 0x4 -------------------- diff --git a/doc/release-notes/skiboot-5.10-rc1.rst b/doc/release-notes/skiboot-5.10-rc1.rst index bf3095103aab..90a5b300531e 100644 --- a/doc/release-notes/skiboot-5.10-rc1.rst +++ b/doc/release-notes/skiboot-5.10-rc1.rst @@ -91,7 +91,7 @@ we look to enabling by default in the next release. The OPAL Quiesce calls are designed to improve reliability and debuggability around reboot and error conditions. See the full API documentation for details: -:ref:`opal-quiesce`. +:ref:`OPAL_QUIESCE`. - fast-reboot: bare bones fast reboot implementation for POWER9 diff --git a/doc/release-notes/skiboot-5.10.rst b/doc/release-notes/skiboot-5.10.rst index 0b22cb688ab4..02438ada3d94 100644 --- a/doc/release-notes/skiboot-5.10.rst +++ b/doc/release-notes/skiboot-5.10.rst @@ -137,7 +137,7 @@ we look to enabling by default in the next release. The OPAL Quiesce calls are designed to improve reliability and debuggability around reboot and error conditions. See the full API documentation for details: -:ref:`opal-quiesce`. +:ref:`OPAL_QUIESCE`. - fast-reboot: bare bones fast reboot implementation for POWER9