Merge pull request #987 from KhronosGroup/const_prefetch

Add const to prefetch and memadvice

Author: gmlueck

adoc/chapters/programming_interface.adoc

@@ -4633,11 +4633,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<event>& depEvents) (3)
+event prefetch(const void* ptr, std::size_t numBytes, const std::vector<event>& depEvents) (3)
 ----
 
 _Effects (1):_ Equivalent to calling [api]#queue::submit# with a command group
@@ -4659,11 +4659,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<event>& depEvents)
 ----
 
@@ -15533,7 +15533,7 @@ The type [code]#T# must be <<device-copyable>>.
 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
@@ -15543,7 +15543,7 @@ queue's device.  For more detail on USM, please see <<sec:usm>>.
 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.

adoc/headers/commandGroupHandler.h

@@ -82,9 +82,9 @@ class handler {
 
   template <typename T> 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
   //

adoc/headers/queue.h

@@ -174,16 +174,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<event>& 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<event>& depEvents);
 
   /* -- Shortcut functions: update_host -- */