]>
git.proxmox.com Git - mirror_edk2.git/blob - EdkCompatibilityPkg/Foundation/Library/EdkIIGlueLib/Include/Library/EdkIIGlueCacheMaintenanceLib.h
3 Copyright (c) 2004 - 2006, Intel Corporation. All rights reserved.<BR>
4 This program and the accompanying materials
5 are licensed and made available under the terms and conditions of the BSD License
6 which accompanies this distribution. The full text of the license may be found at
7 http://opensource.org/licenses/bsd-license.php
9 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
10 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
15 EdkIIGlueCacheMaintenanceLib.h
19 Cache Maintenance Functions
23 #ifndef __EDKII_GLUE_CACHE_MAINTENANCE_LIB_H__
24 #define __EDKII_GLUE_CACHE_MAINTENANCE_LIB_H__
27 #define InvalidateInstructionCache() GlueInvalidateInstructionCache()
31 Invalidates the entire instruction cache in cache coherency domain of the
34 Invalidates the entire instruction cache in cache coherency domain of the
40 GlueInvalidateInstructionCache (
45 Invalidates a range of instruction cache lines in the cache coherency domain
48 Invalidates the instruction cache lines specified by Address and Length. If
49 Address is not aligned on a cache line boundary, then entire instruction
50 cache line containing Address is invalidated. If Address + Length is not
51 aligned on a cache line boundary, then the entire instruction cache line
52 containing Address + Length -1 is invalidated. This function may choose to
53 invalidate the entire instruction cache if that is more efficient than
54 invalidating the specified range. If Length is 0, the no instruction cache
55 lines are invalidated. Address is returned.
57 If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
59 @param Address The base address of the instruction cache lines to
60 invalidate. If the CPU is in a physical addressing mode, then
61 Address is a physical address. If the CPU is in a virtual
62 addressing mode, then Address is a virtual address.
64 @param Length The number of bytes to invalidate from the instruction cache.
71 InvalidateInstructionCacheRange (
77 Writes Back and Invalidates the entire data cache in cache coherency domain
80 Writes Back and Invalidates the entire data cache in cache coherency domain
81 of the calling CPU. This function guarantees that all dirty cache lines are
82 written back to system memory, and also invalidates all the data cache lines
83 in the cache coherency domain of the calling CPU.
88 WriteBackInvalidateDataCache (
93 Writes Back and Invalidates a range of data cache lines in the cache
94 coherency domain of the calling CPU.
96 Writes Back and Invalidate the data cache lines specified by Address and
97 Length. If Address is not aligned on a cache line boundary, then entire data
98 cache line containing Address is written back and invalidated. If Address +
99 Length is not aligned on a cache line boundary, then the entire data cache
100 line containing Address + Length -1 is written back and invalidated. This
101 function may choose to write back and invalidate the entire data cache if
102 that is more efficient than writing back and invalidating the specified
103 range. If Length is 0, the no data cache lines are written back and
104 invalidated. Address is returned.
106 If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
108 @param Address The base address of the data cache lines to write back and
109 invalidate. If the CPU is in a physical addressing mode, then
110 Address is a physical address. If the CPU is in a virtual
111 addressing mode, then Address is a virtual address.
112 @param Length The number of bytes to write back and invalidate from the
120 WriteBackInvalidateDataCacheRange (
126 Writes Back the entire data cache in cache coherency domain of the calling
129 Writes Back the entire data cache in cache coherency domain of the calling
130 CPU. This function guarantees that all dirty cache lines are written back to
131 system memory. This function may also invalidate all the data cache lines in
132 the cache coherency domain of the calling CPU.
142 Writes Back a range of data cache lines in the cache coherency domain of the
145 Writes Back the data cache lines specified by Address and Length. If Address
146 is not aligned on a cache line boundary, then entire data cache line
147 containing Address is written back. If Address + Length is not aligned on a
148 cache line boundary, then the entire data cache line containing Address +
149 Length -1 is written back. This function may choose to write back the entire
150 data cache if that is more efficient than writing back the specified range.
151 If Length is 0, the no data cache lines are written back. This function may
152 also invalidate all the data cache lines in the specified range of the cache
153 coherency domain of the calling CPU. Address is returned.
155 If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
157 @param Address The base address of the data cache lines to write back. If
158 the CPU is in a physical addressing mode, then Address is a
159 physical address. If the CPU is in a virtual addressing
160 mode, then Address is a virtual address.
161 @param Length The number of bytes to write back from the data cache.
168 WriteBackDataCacheRange (
174 Invalidates the entire data cache in cache coherency domain of the calling
177 Invalidates the entire data cache in cache coherency domain of the calling
178 CPU. This function must be used with care because dirty cache lines are not
179 written back to system memory. It is typically used for cache diagnostics. If
180 the CPU does not support invalidation of the entire data cache, then a write
181 back and invalidate operation should be performed on the entire data cache.
186 InvalidateDataCache (
191 Invalidates a range of data cache lines in the cache coherency domain of the
194 Invalidates the data cache lines specified by Address and Length. If Address
195 is not aligned on a cache line boundary, then entire data cache line
196 containing Address is invalidated. If Address + Length is not aligned on a
197 cache line boundary, then the entire data cache line containing Address +
198 Length -1 is invalidated. This function must never invalidate any cache lines
199 outside the specified range. If Length is 0, the no data cache lines are
200 invalidated. Address is returned. This function must be used with care
201 because dirty cache lines are not written back to system memory. It is
202 typically used for cache diagnostics. If the CPU does not support
203 invalidation of a data cache range, then a write back and invalidate
204 operation should be performed on the data cache range.
206 If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
208 @param Address The base address of the data cache lines to invalidate. If
209 the CPU is in a physical addressing mode, then Address is a
210 physical address. If the CPU is in a virtual addressing mode,
211 then Address is a virtual address.
212 @param Length The number of bytes to invalidate from the data cache.
219 InvalidateDataCacheRange (