19.1. Working with AOCL Library Sources via Git Submodules - 5.2 English - 57404

For easier access to all AOCL library sources, we have included them as git submodules under the submodules branch of the repository:

$ git clone --recurse-submodules https://github.com/amd/aocl.git -b submodules
$ cd aocl/submodules  # Navigate to AOCL library sources

or

$ git clone --recurse-submodules git@github.com:amd/aocl.git -b submodules
$ cd aocl/submodules  # Navigate to AOCL library sources

The git submodules include: AOCL-BLAS, AOCL-Compression, AOCL-Cryptography, AOCL-Data-Analytics, AOCL-LAPACK, AOCL-LibM, AOCL-LibMem, AOCL-ScaLAPACK, AOCL-Sparse, and AOCL-Utils.

Alternatively, only selected submodules can be downloaded. The following table shows the mapping between AOCL library names and their corresponding submodule names:

Example 1: Download only AOCL-BLAS, AOCL-LAPACK, and AOCL-Utils

$ git clone https://github.com/amd/aocl.git -b submodules
$ cd aocl
$ git submodule init
$ git submodule update submodules/blis submodules/libflame submodules/aocl-utils

Example 2: Download only AOCL-Sparse and AOCL-Compression

$ git clone https://github.com/amd/aocl.git -b submodules
$ cd aocl
$ git submodule init
$ git submodule update submodules/aocl-sparse submodules/aocl-compression

This approach provides:

• All AOCL library sources locally available

• Consistent versioning across all components

• Simplified build process without external dependencies

• Offline development capability