Merge pull request #426 from IntelPython/setup_pie

Improvements to setup.py
IntelPython · May 21, 2021 · 32bf0a6 · 32bf0a6
2 parents b3dac2f + d768dbd
commit 32bf0a6
Show file tree

Hide file tree

Showing 14 changed files with 370 additions and 170 deletions.
diff --git a/README.md b/README.md
@@ -67,6 +67,14 @@ For development:
 python setup.py develop
 ```
 
+It is also possible to build dpctl using [DPC++ toolchain](https://github.com/intel/llvm/blob/sycl/sycl/doc/GetStartedGuide.md) instead of oneAPI DPC++. Instead of activating the oneAPI environment, indicate the toolchain installation prefix with `--sycl-compiler-prefix` option, e.g.
+
+```cmd
+python setup.py develop --sycl-compiler-prefix=${DPCPP_ROOT}/llvm/build
+```
+
+Please use `python setup.py develop --help` for more details.
+
 Install Wheel Package from Pypi
 ==================================
 1. Install dpctl

diff --git a/docs/docfiles/user_guides/QuickStart.rst b/docs/docfiles/user_guides/QuickStart.rst
@@ -165,9 +165,19 @@ to build and install
 Building using custom dpcpp
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. todo::
+It is possible to build dpctl from source using .. _DPC++ toolchain: https://github.com/intel/llvm/blob/sycl/sycl/doc/GetStartedGuide.md
+instead of the DPC++ compiler that comes with oneAPI. One reason for doing this
+may be to enable support for CUDA devices.
 
-    Instructions coming soon.
+Following steps in :ref:`Build and Install with setuptools` use command line
+option :code:`--sycl-compiler-prefix`, for example:
+
+.. code-block:: bash
+
+    python setup.py develop --sycl-compiler-prefix=${DPCPP_ROOT}/llvm/build
+
+Available options and their descriptions can be retrieved using option
+:code:`--help`.
 
 Using dpctl
 -----------

diff --git a/dpctl/_sycl_context.pyx b/dpctl/_sycl_context.pyx
@@ -16,6 +16,7 @@
 
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """ Implements SyclContext Cython extension type.
 """

diff --git a/dpctl/_sycl_device.pyx b/dpctl/_sycl_device.pyx
@@ -16,6 +16,7 @@
 
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """ Implements SyclDevice Cython extension type.
 """

diff --git a/dpctl/_sycl_device_factory.pyx b/dpctl/_sycl_device_factory.pyx
@@ -16,6 +16,7 @@
 
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """ This module implements several device creation helper functions:
 

diff --git a/dpctl/_sycl_event.pyx b/dpctl/_sycl_event.pyx
@@ -16,6 +16,7 @@
 
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """ Implements SyclEvent Cython extension type.
 """

diff --git a/dpctl/_sycl_platform.pyx b/dpctl/_sycl_platform.pyx
@@ -16,6 +16,7 @@
 #
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """ Implements SyclPlatform Cython extension type.
 """

diff --git a/dpctl/_sycl_queue.pyx b/dpctl/_sycl_queue.pyx
@@ -16,6 +16,7 @@
 
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """ Implements SyclQueue Cython extension type.
 """

diff --git a/dpctl/_sycl_queue_manager.pyx b/dpctl/_sycl_queue_manager.pyx
@@ -16,6 +16,7 @@
 #
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 from __future__ import print_function
 

diff --git a/dpctl/memory/_memory.pyx b/dpctl/memory/_memory.pyx
@@ -16,6 +16,7 @@
 
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """This file implements Python buffer protocol using Sycl USM shared and host
 allocators. The USM device allocator is also exposed through this module for

diff --git a/dpctl/program/_program.pyx b/dpctl/program/_program.pyx
@@ -16,6 +16,7 @@
 
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """Implements a Python interface for SYCL's program and kernel runtime classes.
 

diff --git a/dpctl/tensor/_usmarray.pyx b/dpctl/tensor/_usmarray.pyx
@@ -16,6 +16,7 @@
 
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 import numpy as np