Volume 2, Part 1: Processor Abstraction Layer
2:389
PAL_COPY_PAL
PAL_COPY_PAL – Copy PAL Code to Memory (256)
Purpose:
Copy relocatable PAL code from the firmware address space to memory.
Calling Conv:
Stacked Registers
Mode:
Physical
Buffer:
Not dependent
Arguments:
Returns:
Status:
Description:
This procedure is called to relocate runtime PAL procedures and PAL PMI code from the
firmware address space to main memory. A value of 0 for the
copy_option
indicates that
the relocation should be performed; a value of 1 indicates that the relocation should not
be performed. This procedure also updates the PALE_PMI entrypoint in hardware. All
other values are reserved.
PAL_COPY_INFO should be called first to determine the size and alignment
requirements of the memory buffer to which the PAL code will be copied. Bit 63 of
target_addr
must be set consistently with the cacheability attribute of the memory
buffer being copied to. It is PAL's responsibility to ensure that the firmware address
space contents that are being copied from, are not in any processor caches. It is the
caller’s responsibility to ensure that the contents of the memory buffer copied to, are
flushed out of the internal processor's data caches if
target_addr
has a cacheable
memory attribute.
If a PAL procedure makes calls to internal PAL functions that execute only out of the
firmware address space, that portion of code will continue to execute out of the
firmware address space, even though the main procedure has been copied to RAM. This
is true only for some PAL procedures that can be called only in physical mode.
PAL_COPY_PAL call is mandatory as part of the system boot process. Higher level
firmware should guarantee that PAL_COPY_PAL is called on all processors before OS
launch. This is to guarantee that full processor functionality is available. This procedure
can be called more than once.
Argument
Description
index
Index of PAL_COPY_PAL within the list of PAL procedures.
target_addr
Physical address of a memory buffer to copy relocatable PAL procedures and PAL PMI code.
alloc_size
Unsigned integer denoting the size of the buffer passed by SAL for the copy operation.
copy_option
Unsigned integer indicating whether relocatable PAL code and PAL PMI code should be
copied from firmware address space to main memory.
Return Value
Description
status
Return status of the PAL_COPY_PAL procedure.
proc_offset
Unsigned integer denoting the offset of PAL_PROC in the relocatable segment copied.
Reserved
0
Reserved
0
Status Value
Description
0
Call completed without error
-2
Invalid argument
-3
Call completed with error
Summary of Contents for ITANIUM ARCHITECTURE - SOFTWARE DEVELOPERS VOLUME 3 REV 2.3
Page 1: ......
Page 11: ...x Intel Itanium Architecture Software Developer s Manual Rev 2 3 ...
Page 13: ...1 2 Intel Itanium Architecture Software Developer s Manual Rev 2 3 ...
Page 33: ...1 22 Volume 1 Part 1 Introduction to the Intel Itanium Architecture ...
Page 57: ...1 46 Volume 1 Part 1 Execution Environment ...
Page 147: ...1 136 Intel Itanium Architecture Software Developer s Manual Rev 2 3 ...
Page 149: ...1 138 Volume 1 Part 2 About the Optimization Guide ...
Page 191: ...1 180 Volume 1 Part 2 Predication Control Flow and Instruction Stream ...
Page 230: ......
Page 248: ...236 Intel Itanium Architecture Software Developer s Manual Rev 2 3 ...
Page 250: ...2 2 Intel Itanium Architecture Software Developer s Manual Rev 2 3 ...
Page 264: ...2 16 Volume 2 Part 1 Intel Itanium System Environment ...
Page 380: ...2 132 Volume 2 Part 1 Interruptions ...
Page 398: ...2 150 Volume 2 Part 1 Register Stack Engine ...
Page 486: ...2 238 Volume 2 Part 1 IA 32 Interruption Vector Descriptions ...
Page 750: ...2 502 Intel Itanium Architecture Software Developer s Manual Rev 2 3 ...
Page 754: ...2 506 Volume 2 Part 2 About the System Programmer s Guide ...
Page 796: ...2 548 Volume 2 Part 2 Interruptions and Serialization ...
Page 808: ...2 560 Volume 2 Part 2 Context Management ...
Page 842: ...2 594 Volume 2 Part 2 Floating point System Software ...
Page 850: ...2 602 Volume 2 Part 2 IA 32 Application Support ...
Page 862: ...2 614 Volume 2 Part 2 External Interrupt Architecture ...
Page 870: ...2 622 Volume 2 Part 2 Performance Monitoring Support ...
Page 891: ......
Page 1099: ...3 200 Volume 3 Instruction Reference padd Interruptions Illegal Operation fault ...
Page 1295: ...3 396 Volume 3 Resource and Dependency Semantics ...
Page 1296: ......
Page 1302: ...402 Intel Itanium Architecture Software Developer s Manual Rev 2 3 ...
Page 1494: ...4 192 Volume 4 Base IA 32 Instruction Reference FWAIT Wait See entry for WAIT ...
Page 1647: ...Volume 4 Base IA 32 Instruction Reference 4 345 ROL ROR Rotate See entry for RCL RCR ROL ROR ...
Page 1884: ...4 582 Volume 4 IA 32 SSE Instruction Reference ...
Page 1885: ...Index Intel Itanium Architecture Software Developer s Manual Rev 2 3 Index ...
Page 1886: ...Index Intel Itanium Architecture Software Developer s Manual Rev 2 3 ...
Page 1898: ...INDEX Index 12 Index for Volumes 1 2 3 and 4 ...