From e12fc4ce5d8b4ee254ccfb8bb29f44b307df6d10 Mon Sep 17 00:00:00 2001 From: Greg Lueck Date: Thu, 30 Apr 2026 11:33:29 -0400 Subject: [PATCH] Add const to prefetch and memadvice Cherry pick #987 from main (cherry picked from commit 4c7b5864824ac8de39fcf59d1eb24b71d7faf11a) --- adoc/chapters/programming_interface.adoc | 16 ++++++++-------- adoc/headers/commandGroupHandler.h | 4 ++-- adoc/headers/queue.h | 12 ++++++------ 3 files changed, 16 insertions(+), 16 deletions(-) diff --git a/adoc/chapters/programming_interface.adoc b/adoc/chapters/programming_interface.adoc index 86a09b11f..250cfacf0 100644 --- a/adoc/chapters/programming_interface.adoc +++ b/adoc/chapters/programming_interface.adoc @@ -4622,11 +4622,11 @@ queue. .[apidef]#queue::prefetch# [source,role=synopsis,id=api:queue-prefetch] ---- -event prefetch(void* ptr, std::size_t numBytes) (1) +event prefetch(const void* ptr, std::size_t numBytes) (1) -event prefetch(void* ptr, std::size_t numBytes, event depEvent) (2) +event prefetch(const void* ptr, std::size_t numBytes, event depEvent) (2) -event prefetch(void* ptr, std::size_t numBytes, const std::vector& depEvents) (3) +event prefetch(const void* ptr, std::size_t numBytes, const std::vector& depEvents) (3) ---- _Effects (1):_ Equivalent to calling [api]#queue::submit# with a command group @@ -4648,11 +4648,11 @@ queue. .[apidef]#queue::mem_advise# [source,role=synopsis,id=api:queue-mem-advise] ---- -event mem_advise(void* ptr, std::size_t numBytes, int advice) (1) +event mem_advise(const void* ptr, std::size_t numBytes, int advice) (1) -event mem_advise(void* ptr, std::size_t numBytes, int advice, event depEvent) (2) +event mem_advise(const void* ptr, std::size_t numBytes, int advice, event depEvent) (2) -event mem_advise(void* ptr, std::size_t numBytes, int advice, (3) +event mem_advise(const void* ptr, std::size_t numBytes, int advice, (3) const std::vector& depEvents) ---- @@ -15372,7 +15372,7 @@ The type [code]#T# must be <>. a@ [source] ---- -void prefetch(void* ptr, std::size_t numBytes) +void prefetch(const void* ptr, std::size_t numBytes) ---- a@ Enqueues a prefetch of [code]#num_bytes# of data starting at address [code]#ptr#. The [code]#ptr# must point within a USM allocation from the same @@ -15382,7 +15382,7 @@ queue's device. For more detail on USM, please see <>. a@ [source] ---- -void mem_advise(void* ptr, std::size_t numBytes, int advice) +void mem_advise(const void* ptr, std::size_t numBytes, int advice) ---- a@ Enqueues a command that provides information to the implementation about a region of USM starting at [code]#ptr# and extending for [code]#numBytes# bytes. diff --git a/adoc/headers/commandGroupHandler.h b/adoc/headers/commandGroupHandler.h index f1d0b6cd0..080ada6be 100644 --- a/adoc/headers/commandGroupHandler.h +++ b/adoc/headers/commandGroupHandler.h @@ -82,9 +82,9 @@ class handler { template void fill(void* ptr, const T& pattern, std::size_t count); - void prefetch(void* ptr, std::size_t numBytes); + void prefetch(const void* ptr, std::size_t numBytes); - void mem_advise(void* ptr, std::size_t numBytes, int advice); + void mem_advise(const void* ptr, std::size_t numBytes, int advice); //------ Explicit memory operation APIs // diff --git a/adoc/headers/queue.h b/adoc/headers/queue.h index bd1d2984d..ebdf5483b 100644 --- a/adoc/headers/queue.h +++ b/adoc/headers/queue.h @@ -173,16 +173,16 @@ class queue { /* -- Shortcut functions: prefetch -- */ - event prefetch(void* ptr, std::size_t numBytes); - event prefetch(void* ptr, std::size_t numBytes, event depEvent); - event prefetch(void* ptr, std::size_t numBytes, + event prefetch(const void* ptr, std::size_t numBytes); + event prefetch(const void* ptr, std::size_t numBytes, event depEvent); + event prefetch(const void* ptr, std::size_t numBytes, const std::vector& depEvents); /* -- Shortcut functions: mem_advise -- */ - event mem_advise(void* ptr, std::size_t numBytes, int advice); - event mem_advise(void* ptr, std::size_t numBytes, int advice, event depEvent); - event mem_advise(void* ptr, std::size_t numBytes, int advice, + event mem_advise(const void* ptr, std::size_t numBytes, int advice); + event mem_advise(const void* ptr, std::size_t numBytes, int advice, event depEvent); + event mem_advise(const void* ptr, std::size_t numBytes, int advice, const std::vector& depEvents); /* -- Shortcut functions: update_host -- */