[PATCH] Documentation: Update x86 Communication Region description

7 views
Skip to first unread message

Jan Kiszka

unread,
Nov 28, 2017, 1:18:31 AM11/28/17
to Jailhouse, Henning Schild
From: Jan Kiszka <jan.k...@siemens.com>

The platform information recently gained some new fields. List them.
Reformat the generic region as well for visual consistency.

Signed-off-by: Jan Kiszka <jan.k...@siemens.com>
---

Decided to patch on top as we were already outdated before the recent
patch.

Documentation/hypervisor-interfaces.txt | 42 +++++++++++++++++++--------------
1 file changed, 24 insertions(+), 18 deletions(-)

diff --git a/Documentation/hypervisor-interfaces.txt b/Documentation/hypervisor-interfaces.txt
index 0e529db0..8dd58750 100644
--- a/Documentation/hypervisor-interfaces.txt
+++ b/Documentation/hypervisor-interfaces.txt
@@ -284,17 +284,17 @@ is mapped, it has to be declared read-only in the cell configuration.
Communication region layout
- - - - - - - - - - - - - -

- +------------------------------+ - begin of communication region
- | Message to Cell (32 bit) | (lower address)
- +------------------------------+
- | Message from Cell (32 bit) |
- +------------------------------+
- | Cell State (32 bit) |
- +------------------------------+
- | Reserved (32 bit) |
- +------------------------------+
- : Platform Information :
- +------------------------------+ - higher address
+ +------------------------------+ - begin of communication region
+ | Message to Cell (32 bit) | (lower address)
+ +------------------------------+
+ | Message from Cell (32 bit) |
+ +------------------------------+
+ | Cell State (32 bit) |
+ +------------------------------+
+ | Reserved (32 bit) |
+ +------------------------------+
+ : Platform Information :
+ +------------------------------+ - higher address

All fields use the native endianness of the system. The format is of the
Platform Information part is architecture-specific. Its content is filled by
@@ -379,13 +379,19 @@ to "Running".
Platform Information for x86
- - - - - - - - - - - - - - -

- +------------------------------+ - begin of communication region
- : generic part, see above : (lower address)
- +------------------------------+
- | PM Timer Address (16 bit) |
- +------------------------------+
- | Number of CPUs (16 bit) |
- +------------------------------+ - higher address
+ +----------------------------------+ - begin of communication region
+ : generic part, see above : (lower address)
+ +----------------------------------+
+ | PCI MMCONFIG Address (64 bit) |
+ +----------------------------------+
+ | PM Timer Address (16 bit) |
+ +----------------------------------+
+ | Number of CPUs (16 bit) |
+ +----------------------------------+
+ | TSC Frequency in kHz (32 bit) |
+ +----------------------------------+
+ | APIC Timer Freq. in kHz (32 bit) |
+ +----------------------------------+ - higher address


References
--
2.12.3
Reply all
Reply to author
Forward
0 new messages