summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorZhigang Gong <zhigang.gong@linux.intel.com>2013-06-25 18:04:53 +0800
committerZhigang Gong <zhigang.gong@linux.intel.com>2013-06-25 18:55:08 +0800
commit97c3a9b076ccd24af09fb6ce3f2be7b8e3f93a4f (patch)
tree1650dbb208d4ceae5a8ff7dd37a91c1a6e13941e /README.md
parent7508682d00101231230b6dbbb20b51c5d67deb17 (diff)
Docs: Rearrange documents according to wiki page on fd.o.
We use fd.o wiki to host our documents. To make the maintainence easier, I change the direcotry and some links in the markdown files. And make them the same as fd.o's. Signed-off-by: Zhigang Gong <zhigang.gong@linux.intel.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md140
1 files changed, 2 insertions, 138 deletions
diff --git a/README.md b/README.md
index 6e741129..cbaeaa95 100644
--- a/README.md
+++ b/README.md
@@ -1,138 +1,2 @@
-Beignet
-=======
-
-Beignet is an open source implementaion of the OpenCL specification - a generic
-compute oriented API. This code base contains the code to run OpenCL programs on
-Intel GPUs which bsically defines and implements the OpenCL host functions
-required to initialize the device, create the command queues, the kernels and
-the programs and run them on the GPU. The code base also contains the compiler
-part of the stack which is included in `backend/`. For more specific information
-about the compiler, please refer to `backend/README.md`
-
-How to build
-------------
-
-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
-
-`> mkdir build`
-
-`> cd build`
-
-`> cmake ../ # to configure`
-
-Choose whatever you want for the build.
-
-Then press 'c' to configure and 'g' to generate the code.
-
-`> make`
-
-The project depends on several external libraries:
-
-- Several X components (XLib, Xfixes, Xext)
-- libdrm libraries (libdrm and libdrm\_intel)
-- Various LLVM components
-- The compiler backend itself (libgbe)
-- Mesa git master version built with gbm enabled to support extension cl\_khr\_gl\_sharing.
-
-CMake will check the dependencies and will complain if it does not find them.
-
-The cmake will also build the backend project. Please refer to:
-[OpenCL Gen Backend](backend/README.html) to get more dependencies.
-
-Once built, the run-time produces a shared object libcl.so which basically
-directly implements the OpenCL API. A set of tests are also produced. They may
-be found in `utests/`.
-
-Note that the compiler depends on LLVM (Low-Level Virtual Machine project).
-Right now, the code has been compiled with LLVM 3.1/3.2. It will not compile
-with any thing older.
-
-[http://llvm.org/releases/](http://llvm.org/releases/)
-
-LLVM 3.1 and 3.2 are supported.
-
-Also note that the code was compiled on GCC 4.6 and GCC 4.7. Since the code uses
-really recent C++11 features, you may expect problems with older compilers. Last
-time I tried, the code breaks ICC 12 and Clang with internal compiler errors
-while compiling anonymous nested lambda functions.
-
-How to run
-----------
-
-Apart from the OpenCL library itself that can be used by any OpenCL application,
-this code also produces various tests to ensure the compiler and the run-time
-consistency. This small test framework uses a simple c++ registration system to
-register all the unit tests.
-
-You need to set the variable `OCL_KERNEL_PATH` to locate the OCL kernels. They
-are with the run-time in `./kernels`.
-
-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
-
-Supported Hardware
-------------------
-
-The code was tested on IVB GT2 with ubuntu and fedora core distribution.
-Currently Only IVB is supported right now. Actually, the code was only run on IVB GT2. You
-may expect some issues with IVB GT1.
-
-TODO
-----
-
-The run-time is far from being complete. Most of the pieces have been put
-together to test and develop the OpenCL compiler. A partial list of things to
-do:
-
-- Complete cl\_khr\_gl\_sharing support. We lack of some APIs implementation such
- as clCreateFromGLBuffer,clCreateFromGLRenderbuffer,clGetGLObjectInfo... Currently,
- the working APIs are clCreateFromGLTexture,clCreateFromGLTexture2D.
-
-- Support for events.
-
-- Check that NDRangeKernels can be pushed into _different_ queues from several
- threads.
-
-- Support for nonblocking mode Enqueue\*Buffer. Now we only use the map extension to
- implement those Enqueue\*Buffer functions.
-
-- No state tracking at all. One batch buffer is created at each "draw call"
- (i.e. for each NDRangeKernels). This is really inefficient since some
- expensive pipe controls are issued for each batch buffer
-
-- Valgrind reports some leaks in libdrm. It sounds like a false positive but it
- has to be checked. Idem for LLVM. There is one leak here to check.
-
-More generally, everything in the run-time that triggers the "FATAL" macro means
-that something that must be supported is not implemented properly (either it
-does not comply with the standard or it is just missing)
-
-Project repository
-------------------
-Right now, we host our project on fdo at: git://anongit.freedesktop.org/beignet.
-
-The team
---------
-This project was created by Ben Segovia when he was working for Intel. Now we
-have a team in China OTC graphics department continue to work on this project.
-The official contact for this project is: Zou Nanhai (<nanhai.zou@intel.com>).
-
-How to contribute
------------------
-You are always welcome to contribute to this project, just need to subscribe
-to the beignet mail list and send patches to it for review.
-The official mail list is as below:
-http://lists.freedesktop.org/mailman/listinfo/beignet
+We host documents at the following wiki page:
+[http://wiki.freedesktop.org/www/Software/Beignet](http://wiki.freedesktop.org/www/Software/Beignet)