Corpora in 'corpus' directory contain UR API calls in a predefined order described below. All such scenarios begin with single calls to urLoaderInit() and urAdapterGet(). Corpus files are binary files containing ASCII characters which are interpreted by the test backwards, meaning that bytes are read from the end of the file to the beginning of the file.

More corpora can be generated by fuzzer. Just run the test with a first positional parameter which provides the path where any new corpus will be saved. The path has to exist. It's worth running the test with tracing enabled while picking scenarios to be added to the repository for future short fuzz tests runs. Example of running the test with generating new corpus files:

UR_ADAPTERS_FORCE_LOAD=build/lib/libur_adapter_null.so \
XPTI_TRACE_ENABLE=1 \
XPTI_FRAMEWORK_DISPATCHER=build/lib/libxptifw.so \
XPTI_SUBSCRIBERS=build/lib/libcollector.so \
UR_ENABLE_LAYERS=UR_LAYER_TRACING \
./build/bin/fuzztest-base test/fuzz/corpus -seed=1 -max_total_time=120 -verbosity=1

Pass path to a corpus file instead to run a single scenario:

UR_ADAPTERS_FORCE_LOAD=build/lib/libur_adapter_null.so \
XPTI_TRACE_ENABLE=1 \
XPTI_FRAMEWORK_DISPATCHER=build/lib/libxptifw.so \
XPTI_SUBSCRIBERS=build/lib/libcollector.so \
UR_ENABLE_LAYERS=UR_LAYER_TRACING \
./build/bin/fuzztest-base test/fuzz/corpus/alloc -verbosity=1

More details on seed corpora for fuzzer can be found here.

Test device/context/pool create and release

urPlatformGet() urPlatformGet() urDeviceGet() urDeviceGet() urDeviceRelease() urDeviceGet() urDeviceGet() urContextCreate() urContextRelease() urContextCreate() urUSMPoolCreate() urUSMPoolCreate() urUSMPoolRelease() urUSMPoolRelease() urUSMPoolCreate() urUSMPoolCreate() urUSMPoolCreate() urUSMPoolCreate() urUSMPoolRelease() urUSMPoolRelease() urUSMPoolRelease() urUSMPoolRelease() urContextRelease()

Allocate with host and device pools

urPlatformGet() urPlatformGet() urDeviceGet() urDeviceGet() urContextCreate() urUSMPoolCreate() urUSMPoolCreate() urUSMPoolCreate() urUSMPoolCreate() urUSMHostAlloc() urUSMDeviceAlloc() urUSMFree() urUSMPoolRelease() urUSMPoolRelease() urUSMFree() urUSMPoolRelease() urUSMPoolRelease() urContextRelease()

Allocate on host/device, no pools

urPlatformGet() urPlatformGet() urDeviceGet() urDeviceGet() urContextCreate() urUSMHostAlloc() urUSMDeviceAlloc() urUSMFree() urUSMFree() urContextRelease()

Launch kernel

urPlatformGet() urPlatformGet() urDeviceGet() urDeviceGet() urContextCreate() urProgramCreateWithIL() urProgramBuild() urKernelCreate() urQueueCreate() urEnqueueKernelLaunch() urEventWait() urEventRelease() urQueueFinish() urQueueRelease() urKernelRelease() urProgramRelease() urContextRelease()