Intel ITANIUM ARCHITECTURE - SOFTWARE DEVELOPERS MANUAL VOLUME 1 REV 2.3 Manual page 721

PAL_VP_ENV_INFO – PAL Virtual Environment Information (266)
Returns the parameters needed to enter a virtual environment.
Purpose:
Stacked Registers
Calling Conv:
Virtual
Mode:
Dependent
Buffer:
Arguments:
Argument
index
Reserved
Reserved
Reserved
Returns:
Return Value
status
buffer_size
vp_env_info
Reserved
Status:
Status Value
0
-1
-2
-3
-9
This procedure returns the configuration options and the PAL virtual environment buffer
Description:
size required by PAL_VP_INIT_ENV. This procedure is used by the VMM to setup a
virtual environment and determine the amount of memory / resources required. The
VMM can then allocate the required amount of physical memory, set up the virtual to
physical instruction and data translations that cover the PAL virtual environment buffer
in TRs and call PAL_VP_INIT_ENV. The buffer allocated must be at least 4K aligned.
On a multiprocessor system, this procedure need only be invoked once (on any one
logical processor) to obtain virtual environment information.
This procedure returns unimplemented procedure when virtual machine features are
disabled. See
"PAL_PROC_GET_FEATURES – Get Processor Dependent Features (17)" on page 2:446
for details.
Table 11-118. vp_env_info – Virtual Environment Information Parameter
Field
Reserved
opcode
Reserved
gitc
Volume 2, Part 1: Processor Abstraction Layer
Description
Index of PAL_VP_ENV_INFO within the list of PAL procedures
0
0
0
Description
Return status of the PAL_VP_ENV_INFO procedure
Unsigned integer denoting the number of bytes required by the PAL virtual environment
buffer during PAL_VP_INIT_ENV
64-bit vector of virtual environment information. See
0
Description
Call completed without error
Unimplemented procedure
Invalid argument
Call completed with error
Call requires PAL memory buffer
Section 3.4, "Processor Virtualization" on page 2:44
Bit
7:0 Reserved
8 If 1, hardware support to provide opcode information during PAL intercepts is available.
The opcode (and the decoding of cause) passed as parameters to the VMM on inter-
cept will represent the instruction that triggered the intercept.
If 0, opcode information during PAL intercepts is provided by PAL. The opcode (and the
decoding of cause) passed as parameters to the VMM on intercept will not necessarily
represent the instruction that triggered the intercept, but may represent some value
that was written to memory between the time the instruction that triggered the intercept
was fetched, and when the intercept was triggered.
9 Reserved
10 If 1, guest MOV-from-AR.ITC optimization is supported.
If 0, guest MOV-from-AR.ITC optimization is not supported.
PAL_VP_ENV_INFO
Table 11-118. for details
and
Description
a
2:473