summaryrefslogtreecommitdiffstats
path: root/source/code.rst
blob: 4ceb072be408ea963da9d0a56fb441159e50b80e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
Code
====

In order to backport the Linux kernel we must divide and conquer the
tasks at hand.

This is now deprecated use :doc:`hacking on backports <documentation/backports/hacking>`.

Backport components
-------------------

There are currently two components to the backports effort.

compat
~~~~~~

compat is a shared module / headers that implements newer features for usage on older kernels.

- git://github.com/mcgrof/compat.git>`__
- :doc:`documentation/compat`

compat-drivers
~~~~~~~~~~~~~~

compat-drivers is the framework that pulls code from the Linux kernel,
adds the compat module and backports features that compat could not
backport within its module / headers.

- git://github.com/mcgrof/compat-drivers.git``
- :doc:`documentation/compat-drivers`

Getting all required code
-------------------------

To be able to make releases and test building releases however you need
quite a bit more code. The setup is simplified with scripts from the
compat.git tree. To set your system up for the first time you can run::

   wget https://github.com/mcgrof/compat/raw/master/bin/get-compat-trees
   wget https://github.com/mcgrof/compat/raw/master/bin/get-compat-kernels

   chmod 755 get-compat-trees get-compat-kernels 

   ./get-compat-trees
   ./get-compat-kernels

Hacking on the project
----------------------

You should realize that there are a few components to the project and
that although they are used together each one can be considered
independent of each other.

- Read the :doc:`hacking on compat documentation <documentation/compat>`
- Read the :doc:`hacking on compat-drivers documentation <documentation/compat-drivers>`

TODO list
~~~~~~~~~

Read the :doc:`hacking TODO <documentation/compat-drivers/hacking>` for
a list of wish items we should be working towards.