.. | .. |
---|
5 | 5 | |
---|
6 | 6 | This document is intended to explain how to submit device drivers to the |
---|
7 | 7 | various kernel trees. Note that if you are interested in video card drivers |
---|
8 | | -you should probably talk to XFree86 (http://www.xfree86.org/) and/or X.Org |
---|
9 | | -(http://x.org/) instead. |
---|
| 8 | +you should probably talk to XFree86 (https://www.xfree86.org/) and/or X.Org |
---|
| 9 | +(https://x.org/) instead. |
---|
10 | 10 | |
---|
11 | 11 | .. note:: |
---|
12 | 12 | |
---|
.. | .. |
---|
16 | 16 | |
---|
17 | 17 | Oh, and we don't really recommend submitting changes to XFree86 :) |
---|
18 | 18 | |
---|
19 | | -Also read the Documentation/process/submitting-patches.rst document. |
---|
| 19 | +Also read the :ref:`Documentation/process/submitting-patches.rst <submittingpatches>` |
---|
| 20 | +document. |
---|
20 | 21 | |
---|
21 | 22 | |
---|
22 | 23 | Allocating Device Numbers |
---|
.. | .. |
---|
24 | 25 | |
---|
25 | 26 | Major and minor numbers for block and character devices are allocated |
---|
26 | 27 | by the Linux assigned name and number authority (currently this is |
---|
27 | | -Torben Mathiasen). The site is http://www.lanana.org/. This |
---|
| 28 | +Torben Mathiasen). The site is https://www.lanana.org/. This |
---|
28 | 29 | also deals with allocating numbers for devices that are not going to |
---|
29 | 30 | be submitted to the mainstream kernel. |
---|
30 | | -See Documentation/admin-guide/devices.rst for more information on this. |
---|
| 31 | +See :ref:`Documentation/admin-guide/devices.rst <admin_devices>` |
---|
| 32 | +for more information on this. |
---|
31 | 33 | |
---|
32 | 34 | If you don't use assigned numbers then when your device is submitted it will |
---|
33 | 35 | be given an assigned number even if that is different from values you may |
---|
.. | .. |
---|
58 | 60 | |
---|
59 | 61 | Licensing: |
---|
60 | 62 | The code must be released to us under the |
---|
61 | | - GNU General Public License. We don't insist on any kind |
---|
62 | | - of exclusive GPL licensing, and if you wish the driver |
---|
63 | | - to be useful to other communities such as BSD you may well |
---|
64 | | - wish to release under multiple licenses. |
---|
| 63 | + GNU General Public License. If you wish the driver to be |
---|
| 64 | + useful to other communities such as BSD you may release |
---|
| 65 | + under multiple licenses. If you choose to release under |
---|
| 66 | + licenses other than the GPL, you should include your |
---|
| 67 | + rationale for your license choices in your cover letter. |
---|
65 | 68 | See accepted licenses at include/linux/module.h |
---|
66 | 69 | |
---|
67 | 70 | Copyright: |
---|
.. | .. |
---|
115 | 118 | implemented") error. You should also try to make sure that your |
---|
116 | 119 | driver uses as little power as possible when it's not doing |
---|
117 | 120 | anything. For the driver testing instructions see |
---|
118 | | - Documentation/power/drivers-testing.txt and for a relatively |
---|
| 121 | + Documentation/power/drivers-testing.rst and for a relatively |
---|
119 | 122 | complete overview of the power management issues related to |
---|
120 | | - drivers see Documentation/driver-api/pm/devices.rst. |
---|
| 123 | + drivers see :ref:`Documentation/driver-api/pm/devices.rst <driverapi_pm_devices>`. |
---|
121 | 124 | |
---|
122 | 125 | Control: |
---|
123 | 126 | In general if there is active maintenance of a driver by |
---|
.. | .. |
---|
153 | 156 | where *country_code* == your country code, such as |
---|
154 | 157 | **us**, **uk**, **fr**, etc. |
---|
155 | 158 | |
---|
156 | | - http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git |
---|
| 159 | + https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git |
---|
157 | 160 | |
---|
158 | 161 | Linux kernel mailing list: |
---|
159 | 162 | linux-kernel@vger.kernel.org |
---|
160 | 163 | [mail majordomo@vger.kernel.org to subscribe] |
---|
161 | 164 | |
---|
162 | 165 | Linux Device Drivers, Third Edition (covers 2.6.10): |
---|
163 | | - http://lwn.net/Kernel/LDD3/ (free version) |
---|
| 166 | + https://lwn.net/Kernel/LDD3/ (free version) |
---|
164 | 167 | |
---|
165 | 168 | LWN.net: |
---|
166 | | - Weekly summary of kernel development activity - http://lwn.net/ |
---|
| 169 | + Weekly summary of kernel development activity - https://lwn.net/ |
---|
167 | 170 | |
---|
168 | 171 | 2.6 API changes: |
---|
169 | 172 | |
---|
170 | | - http://lwn.net/Articles/2.6-kernel-api/ |
---|
| 173 | + https://lwn.net/Articles/2.6-kernel-api/ |
---|
171 | 174 | |
---|
172 | 175 | Porting drivers from prior kernels to 2.6: |
---|
173 | 176 | |
---|
174 | | - http://lwn.net/Articles/driver-porting/ |
---|
| 177 | + https://lwn.net/Articles/driver-porting/ |
---|
175 | 178 | |
---|
176 | 179 | KernelNewbies: |
---|
177 | 180 | Documentation and assistance for new kernel programmers |
---|
178 | 181 | |
---|
179 | | - http://kernelnewbies.org/ |
---|
| 182 | + https://kernelnewbies.org/ |
---|
180 | 183 | |
---|
181 | 184 | Linux USB project: |
---|
182 | 185 | http://www.linux-usb.org/ |
---|
.. | .. |
---|
185 | 188 | http://www.fenrus.org/how-to-not-write-a-device-driver-paper.pdf |
---|
186 | 189 | |
---|
187 | 190 | Kernel Janitor: |
---|
188 | | - http://kernelnewbies.org/KernelJanitors |
---|
| 191 | + https://kernelnewbies.org/KernelJanitors |
---|
189 | 192 | |
---|
190 | 193 | GIT, Fast Version Control System: |
---|
191 | | - http://git-scm.com/ |
---|
| 194 | + https://git-scm.com/ |
---|