1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
|
===================================
Installation and Building for Linux
===================================
-------------
Prerequisites
-------------
- A ROCm enabled platform. More information in `ROCm Documentation <https://docs.amd.com/>`_. To build ROCm from the source, follow the previous link and navigate to How to install ROCm. This page will provide steps to install ROCm for specific operating systems. After following these steps to download the installer amdgpu-install, use the below command to install ROCm.
::
sudo amdgpu-install --usecase=rocm
- rocBLAS is supported on the same Linux versions that are supported by ROCm
----------------------------
Installing Prebuilt Packages
----------------------------
rocBLAS can be installed on Ubuntu(R) or Debian using:
::
sudo apt-get update
sudo apt-get install rocblas
rocBLAS can be installed on CentOS using:
::
sudo yum update
sudo yum install rocblas
rocBLAS can be installed on SLES using:
::
sudo dnf upgrade
sudo dnf install rocblas
Once installed, rocBLAS can be used just like any other library with a C API.
The rocblas.h header file must be included in the user code to make calls
into rocBLAS, and the rocBLAS shared library will become link-time and run-time
dependent for the user application.
Once installed, find rocblas.h and rocblas_module.f90 in the /opt/rocm/include
directory. Only use these two installed files when needed in user code.
Find other rocBLAS files in /opt/rocm/include/internal, However, do not include these files directly.
-------------------------------
Building and Installing rocBLAS
-------------------------------
For most users, building from source is not necessary, as rocBLAS can be used after installing the prebuilt
packages as described above. If desired, users can use following instructions to build rocBLAS from source.
Note the change in the --usecase command argument below to install the base ROCm developer stack in-order to build rocBLAS from the source.
::
sudo amdgpu-install --usecase=rocmdev
Requirements
^^^^^^^^^^^^
As a rule, 64GB of system memory is required for a full rocBLAS build. This value can be lower if
rocBLAS is built with a different Tensile logic target (see the --logic command for ./install.sh). This value
may also increase in the future as more functions are added to rocBLAS and dependencies such as Tensile grow.
Download rocBLAS
^^^^^^^^^^^^^^^^
The rocBLAS source code is available at the `rocBLAS github page <https://github.com/ROCmSoftwarePlatform/rocBLAS>`_. Check the ROCm version on your system. For Ubuntu(R), use:
::
apt show rocm-libs -a
For Centos, use:
::
yum info rocm-libs
The ROCm version has major, minor, and patch fields, possibly followed by a build specific identifier. For example, ROCm version could be 4.0.0.40000-23; this corresponds to major = 4, minor = 0, patch = 0, build identifier 40000-23.
There are GitHub branches at the rocBLAS site with names rocm-major.minor.x where major and minor are the same as in the ROCm version. For ROCm version 4.0.0.40000-23, you must use the following to download rocBLAS:
::
git clone -b release/rocm-rel-x.y https://github.com/ROCmSoftwarePlatform/rocBLAS.git
cd rocBLAS
Replace x.y in the above command with the version of ROCm installed on your machine. For example, if you have ROCm 5.0 installed, then replace release/rocm-rel-x.y with release/rocm-rel-5.0.
Below are steps to build using `install.sh` script. The user can build either:
* dependencies + library
* dependencies + library + client
You only need (dependencies + library) if you call rocBLAS from your code.
The client contains the test and benchmark code.
Library Dependencies
^^^^^^^^^^^^^^^^^^^^
Dependencies are listed in the script install.sh. The -d flag to install.sh installs dependencies.
CMake has a minimum version requirement listed in the file install.sh. See --cmake_install flag in install.sh to upgrade automatically.
Build Library dependencies + Library
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Common uses of install.sh to build (library dependencies + library) are
in the table below:
.. tabularcolumns::
|\X{1}{4}|\X{3}{4}|
+----------------------+--------------------------+
| Command | Description |
+======================+==========================+
| ``./install.sh -h`` | Help information. |
+----------------------+--------------------------+
| ``./install.sh -d`` | Build library |
| | dependencies and library |
| | in your local directory. |
| | The -d flag only needs |
| | to be used once. For |
| | subsequent invocations |
| | of install.sh it is not |
| | necessary to rebuild the |
| | dependencies. |
+----------------------+--------------------------+
| ``./install.sh`` | Build library in your |
| | local directory. It is |
| | assumed dependencies |
| | have been built. |
+----------------------+--------------------------+
| ``./install.sh -i`` | Build library, then |
| | build and install |
| | rocBLAS package in |
| | /opt/rocm/rocblas. You |
| | will be prompted for |
| | sudo access. This will |
| | install for all users. |
| | If you want to keep |
| | rocBLAS in your local |
| | directory, you do not |
| | need the -i flag. |
+----------------------+--------------------------+
Build Library Dependencies + Client Dependencies + Library + Client
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Some client executables are listed in the table below:
====================== =================================================
executable name description
====================== =================================================
rocblas-test runs Google Tests to test the library
rocblas-bench executable to benchmark or test functions
rocblas-example-sscal example C code calling rocblas_sscal function
====================== =================================================
Common uses of install.sh to build (dependencies + library + client) are
in the table below:
.. tabularcolumns::
|\X{1}{4}|\X{3}{4}|
+------------------------+--------------------------+
| Command | Description |
+========================+==========================+
| ``./install.sh -h`` | Help information. |
+------------------------+--------------------------+
| ``./install.sh -dc`` | Build library |
| | dependencies, client |
| | dependencies, library, |
| | and client in your local |
| | directory. The -d flag |
| | only needs to be used |
| | once. For subsequent |
| | invocations of |
| | install.sh it is not |
| | necessary to rebuild the |
| | dependencies. |
+------------------------+--------------------------+
| ``./install.sh -c`` | Build library and client |
| | in your local directory. |
| | It is assumed the |
| | dependencies have been |
| | built. |
+------------------------+--------------------------+
| ``./install.sh -idc`` | Build library |
| | dependencies, client |
| | dependencies, library, |
| | client, then build and |
| | install the rocBLAS |
| | package. You will be |
| | prompted for sudo |
| | access. It is expected |
| | that if you want to |
| | install for all users |
| | you use the -i flag. If |
| | you want to keep rocBLAS |
| | in your local directory, |
| | you do not need the -i |
| | flag. |
+------------------------+--------------------------+
| ``./install.sh -ic`` | Build and install |
| | rocBLAS package, and |
| | build the client. You |
| | will be prompted for |
| | sudo access. This will |
| | install for all users. |
| | If you want to keep |
| | rocBLAS in your local |
| | directory, you do not |
| | need the -i flag. |
+------------------------+--------------------------+
Build Clients without Library
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The rocBLAS clients can be built on their own using `install.sh` with a preexisting rocBLAS library.
Note that the version of the rocBLAS clients being built should match the version of the installed rocBLAS. Find the version of the installed rocBLAS in the installed rocBLAS directory in the file include/internal/rocblas-version.h. Find the version of rocBLAS being built by running ``grep"VERSION_STRING" CMakeLists.txt`` in the rocBLAS directory being built.
.. tabularcolumns::
|\X{1}{4}|\X{3}{4}|
+-------------------------------------+--------------------------+
| Command | Description |
+=====================================+==========================+
| ``./install.sh --clients-only`` | Build rocBLAS clients |
| | and use an installed |
| | rocBLAS library at |
| | ROCM_PATH (/opt/rocm if |
| | not specified). |
+-------------------------------------+--------------------------+
| ``./install.sh --clients-only`` | Build rocBLAS clients |
| ``--library-path /path/to/rocBLAS`` | and use a rocBLAS |
| | library at the specified |
| | location. |
+-------------------------------------+--------------------------+
|
