Back to home page

Project CMSSW displayed by LXR

 
 

    


Warning, /HeterogeneousTest/ROCmOpaque/README.md is written in an unsupported language. File is not indexed.

0001 # Introduction
0002 
0003 The packages `HeterogeneousTest/ROCmDevice`, `HeterogeneousTest/ROCmKernel`,
0004 `HeterogeneousTest/ROCmWrapper` and `HeterogeneousTest/ROCmOpaque` implement a set of libraries,
0005 plugins and tests to exercise the build rules for ROCm.
0006 In particular, these tests show what is supported and what are the limitations implementing
0007 ROCm-based libraries, and using them from multiple plugins.
0008 
0009 
0010 # `HeterogeneousTest/ROCmOpaque`
0011 
0012 The package `HeterogeneousTest/ROCmOpaque` implements a non-ROCm aware library, with functions that
0013 call the wrappers defined in the `HeterogeneousTest/ROCmWrapper` library:
0014 ```c++
0015 namespace cms::rocmtest {
0016 
0017   void opaque_add_vectors_f(...);
0018   void opaque_add_vectors_d(...);
0019 
0020 }  // namespace cms::rocmtest
0021 ```
0022 
0023 The `plugins` directory implements the `ROCmTestOpqaueAdditionModule` `EDAnalyzer` that calls the 
0024 function defined in this library. This plugin shows how the function can be used directly from a 
0025 host-only, non-ROCm aware plugin.
0026 
0027 The `test` directory implements the `testRocmDeviceAdditionOpqaue` test binary that calls the
0028 function defined in this library, and shows how they can be used directly from a host-only, non-ROCm
0029 aware application.
0030 It also contains the `testROCmTestOpqaueAdditionModule.py` python configuration to exercise the
0031 `ROCmTestOpqaueAdditionModule` module.
0032 
0033 
0034 # Other packages
0035 
0036 For various ways in which this library and plugin can be tested, see also the other
0037 `HeterogeneousTest/ROCm...` packages:
0038   - [`HeterogeneousTest/ROCmDevice/README.md`](../../HeterogeneousTest/ROCmDevice/README.md)
0039   - [`HeterogeneousTest/ROCmKernel/README.md`](../../HeterogeneousTest/ROCmKernel/README.md)
0040   - [`HeterogeneousTest/ROCmWrapper/README.md`](../../HeterogeneousTest/ROCmWrapper/README.md)
0041 
0042 
0043 # Combining plugins
0044 
0045 `HeterogeneousTest/ROCmOpaque/test` contains also the `testROCmTestAdditionModules.py` python
0046 configuration that exercise all four plugins in a single application.