[beignet] 13/13: Update/clarify update-docs.patch and description

Rebecca Palmer rnpalmer-guest at moszumanska.debian.org
Mon Apr 25 21:55:12 UTC 2016 

This is an automated email from the git hooks/post-receive script.

rnpalmer-guest pushed a commit to branch master
in repository beignet.

commit b57e621ae3c0df58a82d6e4e20b89118687aa1c0
Author: Rebecca N. Palmer <rebecca_palmer at zoho.com>
Date:   Mon Apr 25 22:38:27 2016 +0100

    Update/clarify update-docs.patch and description
    
    (mostly what hardware is supported)
---
 debian/changelog                 |   6 ++-
 debian/control                   |   8 ++-
 debian/patches/update-docs.patch | 106 ++++++++++++++++++++++++++++-----------
 3 files changed, 87 insertions(+), 33 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index 590d6a0..37ceab8 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,4 +1,4 @@
-beignet (1.1.2-1) UNRELEASED; urgency=medium
+beignet (1.1.2-1) unstable; urgency=medium
 
   * New upstream release.
   * Drop patches applied upstream, refresh others.
@@ -9,8 +9,10 @@ beignet (1.1.2-1) UNRELEASED; urgency=medium
   * Enable bindnow hardening.
   * Update and sort d/copyright.
   * Improve reportbug script.
+  * Update/clarify update-docs.patch and package description
+    (mostly what hardware is supported).
 
- -- Rebecca N. Palmer <rebecca_palmer at zoho.com>  Sun, 24 Apr 2016 15:31:25 +0100
+ -- Rebecca N. Palmer <rebecca_palmer at zoho.com>  Mon, 25 Apr 2016 22:37:04 +0100
 
 beignet (1.1.1-2) unstable; urgency=medium
 
diff --git a/debian/control b/debian/control
index 7cc8ef3..c351531 100644
--- a/debian/control
+++ b/debian/control
@@ -39,8 +39,12 @@ Description: OpenCL library for Intel GPUs
  CPUs, GPUs and other processors.
  .
  This package contains the shared library for the Intel implementation,
- which supports the integrated GPUs of Ivy Bridge, Bay Trail, Haswell and
- Broadwell processors.
+ which supports the integrated GPUs of Ivy Bridge (ix-3xxx)/Bay Trail and
+ later Intel processors.
+ .
+ Future processors (even in the same family) are likely to require future
+ versions of this package; in Debian stable, these will be provided in
+ -backports.
 
 Package: beignet-dev
 Section: libdevel
diff --git a/debian/patches/update-docs.patch b/debian/patches/update-docs.patch
index 7f4e14e..aa03d30 100644
--- a/debian/patches/update-docs.patch
+++ b/debian/patches/update-docs.patch
@@ -1,7 +1,8 @@
 Description: Update documentation
 
 Reflect #767148 fix, high precision now being default, and releases.
-Use the Debian documentation path in the error message.
+Clarify what hardware is supported.
+Add Debian specific information.
 
 Author: Rebecca N. Palmer <rebecca_palmer at zoho.com>
 
@@ -18,20 +19,68 @@ index e9e2c16..3227340 100644
                               test_data[0], test_data[1], test_data[2]);
  
                      }
-diff --git a/docs/Beignet.mdwn b/docs/Beignet.mdwn
-index 9a2b516..72cf25e 100644
---- a/docs/Beignet.mdwn
-+++ b/docs/Beignet.mdwn
-@@ -142,7 +142,7 @@ Supported Targets
+diff --git a/docs/Beignet/Backend.mdwn b/docs/Beignet/Backend.mdwn
+index 583e5d2..e0de7bf 100644
+--- a/docs/Beignet/Backend.mdwn
++++ b/docs/Beignet/Backend.mdwn
+@@ -37,9 +37,7 @@ Environment variables are used all over the code. Most important ones are:
+   precision math instructions compliant with OpenCL Spec. So we provide a
+   software version to meet the high precision requirement. Obviously the
+   software version's performance is not as good as native version supported by
+-  GEN hardware. What's more, most graphics application don't need this high
+-  precision, so we choose 0 as the default value. So OpenCL apps do not suffer
+-  the performance penalty for using high precision math functions.
++  GEN hardware.
  
-  * 3rd Generation Intel Core Processors
-  * Intel “Bay Trail” platforms with Intel HD Graphics
-- * 4th Generation Intel Core Processors "Haswell", need kernel patch currently, see the "Known Issues" section.
-+ * 4th Generation Intel Core Processors "Haswell", with some issues on Linux <= 4.1, see the "Known Issues" section.
-  * 5th Generation Intel Core Processors "Broadwell".
+ - `OCL_SIMD_WIDTH` `(8 or 16)`. Select the number of lanes per hardware thread,
+   Normally, you don't need to set it, we will select suitable simd width for
+--- beignet-1.1.2.orig/docs/Beignet.mdwn
++++ beignet-1.1.2/docs/Beignet.mdwn
+@@ -9,6 +9,19 @@ the programs and run them on the GPU. Th
+ part of the stack which is included in `backend/`. For more specific information
+ about the compiler, please refer to `backend/README.md`
+ 
++Supported Targets
++-----------------
++
++Beignet aims to support Gen7 and later Intel integrated GPUs, i.e:
++ * Ivy Bridge (ix-3xxx) and later Intel Core processors
++ * Bay Trail and later Intel Atom processors with Intel HD (not PowerVR) graphics
++
++As these GPUs are not necessarily backwards compatible, Beignet will not attempt to use processors it does not recognise.  Hence, processors introduced after this release of Beignet (even within the Skylake family) may require a newer version of beignet-opencl-icd (and possibly the kernel, linux-image-amd64 or -i386): for Debian stable, this [may be available](https://packages.debian.org/search?keywords=beignet-opencl-icd&searchon=names&exact=1&suite=all&section=all) in [-backports](htt [...]
++
++Not all processor models have an integrated GPU, and systems that also have a discrete GPU may disable the integrated GPU: check _xrandr --listproviders_ or see [here](https://nouveau.freedesktop.org/wiki/Optimus/).
++
++Attempting to run Beignet on unsupported hardware should return CL_DEVICE_NOT_FOUND; if it does anything else (especially crashing) please [report a bug](#howtocontribute).
++
+ News
+ ----
+ [[Beignet project news|Beignet/NEWS]]
+@@ -16,6 +29,8 @@ News
+ Prerequisite
+ ------------
+ 
++(for building the upstream source; Debian packages handle this automatically)
++
+ The project depends on the following external libaries:
+ 
+ - libdrm libraries (libdrm and libdrm\_intel)
+@@ -137,14 +152,6 @@ beignet provides two alternative to run:
+ * Run as root without X.
+ * Enable the drm render nodes by passing drm.rnodes=1 to the kernel boot args, then you can run beignet with non-root and without X.
  
+-Supported Targets
+------------------
+-
+- * 3rd Generation Intel Core Processors
+- * Intel “Bay Trail” platforms with Intel HD Graphics
+- * 4th Generation Intel Core Processors "Haswell", need kernel patch currently, see the "Known Issues" section.
+- * 5th Generation Intel Core Processors "Broadwell".
+-
  Known Issues
-@@ -164,7 +164,7 @@ Known Issues
+ ------------
+ 
+@@ -164,7 +171,7 @@ Known Issues
    forever until a reboot.
  
  * "Beignet: self-test failed" and almost all unit tests fail.
@@ -40,7 +89,7 @@ index 9a2b516..72cf25e 100644
    to [c9224fa](https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=c9224faa59c3071ecfa2d4b24592f4eb61e57069))
    enable the register whitelist by default but miss some registers needed
    for Beignet.
-@@ -175,7 +175,7 @@ Known Issues
+@@ -175,7 +182,7 @@ Known Issues
  
    On Haswell hardware, Beignet 1.0.1 to 1.0.3 also required the
    above workaround on later Linux versions, but this _should not_ be
@@ -49,13 +98,13 @@ index 9a2b516..72cf25e 100644
    git master.
  
  * "Beignet: self-test failed" and 15-30 unit tests fail on 4th Generation (Haswell) hardware.
-@@ -183,10 +183,11 @@ Known Issues
+@@ -183,10 +190,11 @@ Known Issues
    Linux <= 4.0, and requires the i915.enable_ppgtt=2 [boot parameter](https://wiki.ubuntu.com/Kernel/KernelBootParameters)
    on Linux 4.1.
    
 -  This will be fixed in Linux 4.2; older versions can be fixed with
 -  [this patch](https://01.org/zh/beignet/downloads/linux-kernel-patch-hsw-support).
-+  This is fixed from Linux 4.2, which is the default in sid/stretch, and available from -backports in jessie:
++  This is fixed in Linux >= 4.2, which is the default in sid/stretch, and available from -backports in jessie:
 +  
 +  `sudo apt-get install -t jessie-backports linux-image-amd64`
    
@@ -64,18 +113,17 @@ index 9a2b516..72cf25e 100644
    
    `export OCL_IGNORE_SELF_TEST=1`
    
-diff --git a/docs/Beignet/Backend.mdwn b/docs/Beignet/Backend.mdwn
-index 583e5d2..e0de7bf 100644
---- a/docs/Beignet/Backend.mdwn
-+++ b/docs/Beignet/Backend.mdwn
-@@ -37,9 +37,7 @@ Environment variables are used all over the code. Most important ones are:
-   precision math instructions compliant with OpenCL Spec. So we provide a
-   software version to meet the high precision requirement. Obviously the
-   software version's performance is not as good as native version supported by
--  GEN hardware. What's more, most graphics application don't need this high
--  precision, so we choose 0 as the default value. So OpenCL apps do not suffer
--  the performance penalty for using high precision math functions.
-+  GEN hardware.
+@@ -295,9 +303,9 @@ The official mail list is as below:
+ [http://lists.freedesktop.org/mailman/listinfo/beignet](http://lists.freedesktop.org/mailman/listinfo/beignet)  
+ The official bugzilla is at:
+ [https://bugs.freedesktop.org/enter_bug.cgi?product=Beignet](https://bugs.freedesktop.org/enter_bug.cgi?product=Beignet)  
+-You are welcome to submit beignet bug. Please be noted, please specify the exact platform
+-information, such as BYT/IVB/HSW/BDW, and GT1/GT2/GT3. You can easily get this information
+-by running the beignet's unit test.
++You may also [report bugs to Debian](https://www.debian.org/Bugs/Reporting) package beignet-opencl-icd.
++
++Please specify your hardware when reporting a bug: _reportbug beignet-opencl-icd_ will automatically include this information.
  
- - `OCL_SIMD_WIDTH` `(8 or 16)`. Select the number of lanes per hardware thread,
-   Normally, you don't need to set it, we will select suitable simd width for
+ Documents for OpenCL application developers
+ -------------------------------------------
+

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-opencl/beignet.git

More information about the Pkg-opencl-commits mailing list