You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: BUILD.md
+25-23Lines changed: 25 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ order to clone/update any dependent repositories.
15
15
16
16
#### Instructions
17
17
* Simply execute the [UpdateCommon.py](Scripts/UpdateCommon.py) python script located in the [Scripts](Scripts) directory:
18
-
*__python Scripts/UpdateCommon.py__
18
+
*`python Scripts/UpdateCommon.py`
19
19
This script will clone any dependent repositories that are not present on the system. If any of the dependent repositories are already
20
20
present on the system, this script will instead do a "git pull" on those repositories to ensure that they are up to date. Please re-run
21
21
this script everytime you pull new changes from GPA repository.
@@ -30,7 +30,7 @@ this script everytime you pull new changes from GPA repository.
30
30
##### Build Instructions
31
31
* Load Build\VS2015\GPUPerfAPI.sln into Visual Studio
32
32
* Build the 64-bit and/or 32-bit configuration
33
-
* After a successful build, the GPUPerfAPI binaries can be found in __GPA\Output\\$(Configuration)\bin__ (for example GPA\Output\Release\bin)
33
+
* After a successful build, the GPUPerfAPI binaries can be found in `GPA\Output\\$(Configuration)\bin` (for example GPA\Output\Release\bin)
34
34
35
35
#### Additional Information
36
36
* The Visual Studio solution includes a Documentation project that allows you to generate the HTML-based source code documentation using Doxygen. In order
@@ -47,31 +47,33 @@ this script everytime you pull new changes from GPA repository.
47
47
48
48
##### Build Instructions
49
49
* cd into the Build\Linux directory
50
-
* Execute __./build.sh__
50
+
* Execute `./build.sh`
51
51
* By default this performs a from-scratch build of the release versions of GPUPerfAPI, both 32-bit and 64-bit binaries.
52
52
* The following arguments can be passed to build.sh to alter the build:
53
-
*__debug__: performs a debug build
54
-
*__skip32bitbuild__: skips building the 32-bit binaries
55
-
*__skipopengl__: skips building the OpenGL version of GPUPerfAPI
56
-
*__skipopengles__: skips building the OpenGLES version of GPUPerfAPI
57
-
*__skipopencl__: skips building the OpenCL version of GPUPerfAPI
58
-
*__skiphsa__: skips building the ROCm/HSA version of GPUPerfAPI
59
-
*__quick__ or __incremental__: performs an incremental build (as opposed to a from-scratch build)
60
-
*__buildinternal__: builds the internal versions of GPUPerfAPI
61
-
*__hsadir__: overrides the location of the ROCm/HSA header files (by default they are expected to be in /opt/rocm/hsa)
53
+
*`debug`: performs a debug build
54
+
*`skip32buildbuild`: skips building the 32-bit binaries
55
+
*`skipopengl`: skips building the OpenGL version of GPUPerfAPI
56
+
*`skipopengles`: skips building the OpenGLES version of GPUPerfAPI
57
+
*`skipopencl`: skips building the OpenCL version of GPUPerfAPI
58
+
*`skiphsa`: skips building the ROCm/HSA version of GPUPerfAPI
59
+
*`quick` or `incremental`: performs an incremental build (as opposed to a from-scratch build)
60
+
*`buildinternal`: builds the internal versions of GPUPerfAPI
61
+
*`hsadir`: overrides the location of the ROCm/HSA header files (by default they are expected to be in /opt/rocm/hsa)
62
+
*`gtestlibdir`: overrides the location of the GoogleTest libraries (by default they are expected to be in Common/Lib/Ext/GoogleTest/1-7/lib/gcc5/x64. There is also a gcc4.x-compatible version in Common/Lib/Ext/GoogleTest/1-7/lib/x64 for use when building on a system with gcc 4.x)
63
+
*`gtestlibdir32`: overrides the location of the 32-bit GoogleTest libraries (by default they are expected to be in Common/Lib/Ext/GoogleTest/1-7/lib/gcc5/x86. There is also a gcc4.x-compatible version in Common/Lib/Ext/GoogleTest/1-7/lib/x86 for use when building on a system with gcc 4.x)
62
64
* After a successful build, the GPUPerfAPI binaries can be found in their respective source file directories. For instance, the binaries for the OpenGL version of GPUPerfAPI (libGPUPerfAPIGL.so) can be found in the Src/GPUPerfAPIGL subdirectory.
63
65
* Example build command line (builds the debug versions of the binaries, skipping the HSA library):
64
66
* ./build.sh debug skiphsa
65
-
* In addition to using the build.sh build script to build all of GPUPerfAPI, you can also build a single API library by executing __make__ in that library's directory. This is useful when making localized changes in a single version of GPUPerfAPI. When using __make__, the following default targets are supported:
66
-
*__\<default\>__: makes the 64-bit release version
67
-
*__x86__: makes the 32-bit release version
68
-
*__Dbg__: makes the 64-bit debug version
69
-
*__Dbgx86__: makes the 32-bit debug version
70
-
*__Internal__: makes the 64-bit release Internal version
71
-
*__Internalx86__: makes the 32-bit release Internal version
72
-
*__DbgInternal__: makes the 64-bit debug Internal version
73
-
*__DbgInternalx86__: makes the 32-bit debug Internal version
74
-
*__Make__ is supported in the following directories (those marked with (*) are required to be built before the others, as they produce static libraries used by the others):
67
+
* In addition to using the build.sh build script to build all of GPUPerfAPI, you can also build a single API library by executing `make` in that library's directory. This is useful when making localized changes in a single version of GPUPerfAPI. When using `make`, the following default targets are supported:
68
+
*`\<default\>`: makes the 64-bit release version
69
+
*`x86`: makes the 32-bit release version
70
+
*`Dbg`: makes the 64-bit debug version
71
+
*`Dbgx86`: makes the 32-bit debug version
72
+
*`Internal`: makes the 64-bit release Internal version
73
+
*`Internalx86`: makes the 32-bit release Internal version
74
+
*`DbgInternal`: makes the 64-bit debug Internal version
75
+
*`DbgInternalx86`: makes the 32-bit debug Internal version
76
+
*`Make` is supported in the following directories (those marked with (*) are required to be built before the others, as they produce static libraries used by the others):
75
77
* DeviceInfo (*)
76
78
* GPUPerfAPI-Common (*)
77
79
* GPUPerfAPICounterGenerator (*)
@@ -80,7 +82,7 @@ this script everytime you pull new changes from GPA repository.
80
82
* GPUPerfAPIGL
81
83
* GPUPerfAPIGLES
82
84
* GPUPerfAPIHSA
83
-
* When using __make__ to build the ROCM/HSA version of GPUPerfAPI, by default the HSA headers are expected to be in /opt/rocm/hsa. You can override this by specifying "HSA_DIR=<dir>" on the make command line:
85
+
* When using `make` to build the ROCM/HSA version of GPUPerfAPI, by default the HSA headers are expected to be in /opt/rocm/hsa. You can override this by specifying "HSA_DIR=<dir>" on the make command line:
84
86
* Example: make Dbg HSA_DIR=/home/user/hsa_dir
85
87
* When building the internal version, each binary filename will also have a "-Internal" suffix (for example libGPUPerfAPIGL-Internal.so)
0 commit comments