blob: 34eb0a224c00e411a193532b1ef4f82d7cd26651 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
|
.. _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.
One parameter is accepted: the OPAL token number.
``OPAL_CHECK_TOKEN`` will return: ::
enum OpalCheckTokenStatus {
OPAL_TOKEN_ABSENT = 0,
OPAL_TOKEN_PRESENT = 1
};
indicating the presence/absence of the particular OPAL_CALL.
``OPAL_CHECK_TOKEN`` is REQUIRED to be implemented by a conformant OPAL implementation.
For skiboot, only positively ancient internal-to-IBM versions were missing
OPAL_CHECK_TOKEN. In this case, OPAL_PARAMETER would be returned. There is no
reason for a host OS to support this behaviour.
|