…o spec

[UR] Add documentation to experimental feature support

…GetInfo

[UR][CTS] Add urMemImageGetInfo tests and missing spec return values

[UR] Device CTS fixes

…elsetargpointer

[UR][CTS] Fix urKernelSetArgPointer tests

- Added bindless images revision 4 API changes
- Fixed some errors from revision 3

Co-authored-by: Isaac Ault <isaac.ault@codeplay.com>
Co-authored-by: Przemek Malon <przemek.malon@codeplay.com>

…-revision-4

[Exp][Bindless Images] Add BI revision 4 functionality

Memory provider:
 Remove the get_last_result function and replace it with
 get_last_error. This primary difference is the addition of
 the pError out parameter which returns a native error code
 emitted from a failed provider function which resulted in returning
 UMA_RESULT_ERROR_MEMORY_PROVIDER_SPECIFIC.

Memory_pool:
 Remove the get_last_result function and replace it with
 get_last_allocation_status. For memory pool, I don't think we care
 about a pool-specific error codes. We do, however, want to know why the
 previous allocation/de-allocation failed. Memory pool allocation
 functions only return a pointer so we need an extra function
 (get_last_allocation_status) to get this information.

use get_last_allocation_error to return last error
from allocation functions.

…-cts-tempalte

[UR] Setup Virtual Memory CTS template

by returning the name directly instead of through out param. This
function is not allowed to fail anyway.

which returns handle to the last failed provider.

This makes error reporting API independent from how
memory pool is using the providers (i.e. whether there is
only a single provider or multiple)

[UR] Install DPCXX

…emGranularityGetInfo

[UR][CTS] Adds CTS coverage for urVirtualMemGranularityGetInfo

[uma] Improve reporting of pool/provider specific errors

…image-readwrite

[UR][CTS] Add urEnqueueMemImageRead/Write tests

to avoid confusion with uniform memory access.

Using `PROJECT_SOURCE_DIR` instead of `CMAKE_SOURCE_DIR` is more
resilient as it will still resolve to the base of the unified runtime
repository even if used as a sub-project.

[uma] rename uma to umf

Fix adapter registry test CMake

…MemCreate

[UR][CTS] Test urPhysicalMem entry-points

…lidation-over-multiple-lines

[UR] Support multi-line functions in rst files

…totypes-fix

[UR][UMF] Fix warning from -Wstrict-prototypes

…ndering

[UR] Fix code-block documentation rendering

…virtual-mem

[UR] Test remaining Virtual Memory entry-points

…-to-api-listing

[UR] Add macro definitions to API Listing documentation

Also remove image map and fill test files as they no longer exist in the API

Update sycl/xpti version

[UR][CTS] Add tests for urEnqueueMemImageCopy

[UR] Fix spelling

Change the order of experimental features in the reStructuredText
`.. toctree::` to be alphabetically sorted. This align the order
experimental features are displayed in the *Experimental Features*
section with the *API Documentation* section.

…rmGetLastError

[UR][CTS] Add CTS tests for urPlatformGetLastError

…rmGetApiVersion

[UR][CTS] Add tests for urPlatformGetApiVersion

Mostly found by codespell.

…nAdapters

Add the cuda adapter to the list of known adapter libraries.

Fix random spelling issues

[ur] Sort experimental feature toctree order

…type

[UR] Automatically generate ur_structure_type_t

ur_device_info_t

…teWithNativeHandle

…rmNativeHandle

[UR][CTS] Add tests for urPlatformGetNaitiveHandle and urPlatformCreateWithNativeHandle

- add TOC to the top-level README file,
- order sections and group them together (incl. new Contrib section),
- clean and unify Markdown syntax a little,
- add new badges for CodeQL and Bandit,
- fix main GHA badge to point to a specific ('cmake') workflow.

[UR] Revamp README file a little

…support

Add BINDLESS_IMAGES_SHARED_USM_SUPPORT to ur_device_info_t

…eviceGlobalVariableReadWrite

[UR][CTS] Add tests for urEnqueueDeviceGlobalRead/Write

…stFix

Correct size of UR_DEVICE_INFO_MEMORY_BUS_WIDTH in CTS test.

instead of relying on global variable init/destruction on
linux and on windows (when building UMF as a shared lib).

In C++ no guarantee is made for initialization order of
static variables across translation units.

This is problematic when an application (e.g. SYCL) wants
to do some cleanup in it's library destructor. Such application
might want to specify priority for it's destructor (to make sure
it's executed before any other library desturctor) but it doesn't
seem to work for static variables.

Memory tracker is still created as a global object when building
UMF as a static lib on Windows - there is no
__attribute__((destructor)) equivalent that would work for static
library.

[umf] create/destroy memory tracker in lib ctor/dtor

Update the `MAKE_LIBRARY_NAME` macro to match the library naming scheme
CMake uses when `VERSION` is specified on macOS, taking the form
`lib<name>.<version>.dylib`. Enable color diagnostics for AppleClang.
And disable the `CMAKE_FIND_FRAMEWORK` option so that in-tree dylibs are
correctly loaded.

Coverity finally started working correctly. Thanks @wlemkows.

Add coverity badge to README

[UR] Allow compilation on apple for OpenCL support

[UMF]: Add missing include to umf/memory_pool_ops.h

[UR] print unions correctly in ur_params

[umf] add extra poolMakeUnique overload to helpers

Add strongly recommended security compiler flags