| // Copyright 2017 The Chromium Authors. All rights reserved. | |
| // Use of this source code is governed by a BSD-style license that can be | |
| // found in the LICENSE file. | |
| #ifndef QUICHE_COMMON_PLATFORM_API_QUICHE_PREFETCH_H_ | |
| #define QUICHE_COMMON_PLATFORM_API_QUICHE_PREFETCH_H_ | |
| #include "quiche_platform_impl/quiche_prefetch_impl.h" | |
| namespace quiche { | |
| // Move data into the cache before it is read, or "prefetch" it. | |
| // | |
| // The value of `addr` is the address of the memory to prefetch. If | |
| // the target and compiler support it, data prefetch instructions are | |
| // generated. If the prefetch is done some time before the memory is | |
| // read, it may be in the cache by the time the read occurs. | |
| // | |
| // The function names specify the temporal locality heuristic applied, | |
| // using the names of Intel prefetch instructions: | |
| // | |
| // T0 - high degree of temporal locality; data should be left in as | |
| // many levels of the cache possible | |
| // T1 - moderate degree of temporal locality | |
| // T2 - low degree of temporal locality | |
| // Nta - no temporal locality, data need not be left in the cache | |
| // after the read | |
| // | |
| // Incorrect or gratuitous use of these functions can degrade | |
| // performance, so use them only when representative benchmarks show | |
| // an improvement. | |
| inline void QuichePrefetchT0(const void* addr) { | |
| return QuichePrefetchT0Impl(addr); | |
| } | |
| } // namespace quiche | |
| #endif // QUICHE_COMMON_PLATFORM_API_QUICHE_PREFETCH_H_ |