[Beignet] [PATCH] add howto for stand alone utest.

[Yang, Rong R]

Pushed, thanks.

> -----Original Message-----
> From: Beignet [mailto:beignet-bounces at lists.freedesktop.org] On Behalf Of
> xionghu.luo at intel.com
> Sent: Friday, May 6, 2016 0:11
> To: beignet at lists.freedesktop.org
> Cc: Luo, Xionghu <xionghu.luo at intel.com>
> Subject: [Beignet] [PATCH] add howto for stand alone utest.
> 
> From: Luo Xionghu <xionghu.luo at intel.com>
> 
> Signed-off-by: Luo Xionghu <xionghu.luo at intel.com>
> ---
>  docs/Beignet.mdwn                       |  1 +
>  docs/howto/stand-alone-utest-howto.mdwn | 51
> +++++++++++++++++++++++++++++++++
>  2 files changed, 52 insertions(+)
>  create mode 100644 docs/howto/stand-alone-utest-howto.mdwn
> 
> diff --git a/docs/Beignet.mdwn b/docs/Beignet.mdwn index
> 363add0..0a6a4cf 100644
> --- a/docs/Beignet.mdwn
> +++ b/docs/Beignet.mdwn
> @@ -307,6 +307,7 @@ Documents for OpenCL application developers
>  - [[Libva Buffer Sharing|Beignet/howto/libva-buffer-sharing-howto]]
>  - [[V4l2 Buffer Sharing|Beignet/howto/v4l2-buffer-sharing-howto]]
>  - [[Video Motion Estimation|Beignet/howto/video-motion-estimation-
> howto]]
> +- [[Stand Alone Unit Test|Beignet/howto/stand-alone-utest-howto]]
> 
>  The wiki URL is as below:
> 
> [http://www.freedesktop.org/wiki/Software/Beignet/](http://www.freede
> sktop.org/wiki/Software/Beignet/)
> diff --git a/docs/howto/stand-alone-utest-howto.mdwn
> b/docs/howto/stand-alone-utest-howto.mdwn
> new file mode 100644
> index 0000000..9532940
> --- /dev/null
> +++ b/docs/howto/stand-alone-utest-howto.mdwn
> @@ -0,0 +1,51 @@
> +Stand Alone Unit Test HowTo
> +====================
> +
> +Beignet provides an independent unit test suite covered most OpenCL
> +language feautures, including more than 800 cases which could run in a
> +few minutes, it should be useful for testing and comparing different
> OpenCL implementations.
> +
> +Prerequisite
> +------------
> +
> +OpenCL ICD. Please check your OpenCL ICD existance by command
> +`pkg-config --libs OpenCL`.
> +
> +Build Stand Alone Unit Test
> +-----------------------------------
> +The project uses CMake with three profiles:
> +
> +1. Debug (-g)
> +2. RelWithDebInfo (-g with optimizations) 3. Release (only
> +optimizations)
> +
> +Basically, from the root directory of the project
> +
> +`> cd utest`
> +
> +`> cmake . # to configure`
> +
> +`> make`
> +
> +Once built, the 'utest_run' is generated in currenty directory.
> +
> +How to run
> +----------
> +
> +You need to call setenv.sh in the utests/ directory to set some
> +environment variables firstly as below:
> +
> +`> . setenv.sh`
> +
> +Then in `utests/`:
> +
> +`> ./utest_run`
> +
> +will run all the unit tests one after the others
> +
> +`> ./utest_run some_unit_test0 some_unit_test1`
> +
> +will only run `some_unit_test0` and `some_unit_test1` tests
> +
> +if the utest_run fail to run, please check /etc/vendors/OpenCL to
> +confirm it calls the expected OpenCL driver, or export LD_LIBRARAY_PATH
> to establish the correct link.
> --
> 2.1.4
> 
> _______________________________________________
> Beignet mailing list
> Beignet at lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/beignet