mirror of
https://github.com/torvalds/linux.git
synced 2024-11-25 05:32:00 +00:00
Replace HTTP links with HTTPS ones: Documentation/process
Rationale: Reduces attack surface on kernel devs opening the links for MITM as HTTPS traffic is much harder to manipulate. Deterministic algorithm: For each file: If not .svg: For each line: If doesn't contain `\bxmlns\b`: For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`: If both the HTTP and HTTPS versions return 200 OK and serve the same content: Replace HTTP with HTTPS. Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de> Acked-by: Miguel Ojeda <miguel.ojeda.sandonis@gmail.com> Link: https://lore.kernel.org/r/20200621133630.46435-1-grandmaster@al2klimov.de Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
parent
c69f22f25f
commit
e7b4311ebc
@ -295,7 +295,7 @@ mainline get there via -mm.
|
||||
The current -mm patch is available in the "mmotm" (-mm of the moment)
|
||||
directory at:
|
||||
|
||||
http://www.ozlabs.org/~akpm/mmotm/
|
||||
https://www.ozlabs.org/~akpm/mmotm/
|
||||
|
||||
Use of the MMOTM tree is likely to be a frustrating experience, though;
|
||||
there is a definite chance that it will not even compile.
|
||||
@ -306,7 +306,7 @@ the mainline is expected to look like after the next merge window closes.
|
||||
Linux-next trees are announced on the linux-kernel and linux-next mailing
|
||||
lists when they are assembled; they can be downloaded from:
|
||||
|
||||
http://www.kernel.org/pub/linux/kernel/next/
|
||||
https://www.kernel.org/pub/linux/kernel/next/
|
||||
|
||||
Linux-next has become an integral part of the kernel development process;
|
||||
all patches merged during a given merge window should really have found
|
||||
@ -365,21 +365,21 @@ to keep up with what other developers (and the mainline) are doing.
|
||||
Git is now packaged by almost all Linux distributions. There is a home
|
||||
page at:
|
||||
|
||||
http://git-scm.com/
|
||||
https://git-scm.com/
|
||||
|
||||
That page has pointers to documentation and tutorials.
|
||||
|
||||
Among the kernel developers who do not use git, the most popular choice is
|
||||
almost certainly Mercurial:
|
||||
|
||||
http://www.selenic.com/mercurial/
|
||||
https://www.selenic.com/mercurial/
|
||||
|
||||
Mercurial shares many features with git, but it provides an interface which
|
||||
many find easier to use.
|
||||
|
||||
The other tool worth knowing about is Quilt:
|
||||
|
||||
http://savannah.nongnu.org/projects/quilt/
|
||||
https://savannah.nongnu.org/projects/quilt/
|
||||
|
||||
Quilt is a patch management system, rather than a source code management
|
||||
system. It does not track history over time; it is, instead, oriented
|
||||
@ -494,7 +494,7 @@ Andrew Morton gives this advice for aspiring kernel developers
|
||||
with others on getting things fixed up (this can require
|
||||
persistence!) but that's fine - it's a part of kernel development.
|
||||
|
||||
(http://lwn.net/Articles/283982/).
|
||||
(https://lwn.net/Articles/283982/).
|
||||
|
||||
In the absence of obvious problems to fix, developers are advised to look
|
||||
at the current lists of regressions and open bugs in general. There is
|
||||
|
@ -210,7 +210,7 @@ breaks? The best answer to this question was expressed by Linus in July,
|
||||
progress at all. Is it two steps forwards, one step back, or one
|
||||
step forward and two steps back?
|
||||
|
||||
(http://lwn.net/Articles/243460/).
|
||||
(https://lwn.net/Articles/243460/).
|
||||
|
||||
An especially unwelcome type of regression is any sort of change to the
|
||||
user-space ABI. Once an interface has been exported to user space, it must
|
||||
@ -323,7 +323,7 @@ other architectures. If you do not happen to have an S/390 system or a
|
||||
Blackfin development board handy, you can still perform the compilation
|
||||
step. A large set of cross compilers for x86 systems can be found at
|
||||
|
||||
http://www.kernel.org/pub/tools/crosstool/
|
||||
https://www.kernel.org/pub/tools/crosstool/
|
||||
|
||||
Some time spent installing and using these compilers will help avoid
|
||||
embarrassment later.
|
||||
|
@ -2,7 +2,7 @@
|
||||
(How to avoid) Botching up ioctls
|
||||
=================================
|
||||
|
||||
From: http://blog.ffwll.ch/2013/11/botching-up-ioctls.html
|
||||
From: https://blog.ffwll.ch/2013/11/botching-up-ioctls.html
|
||||
|
||||
By: Daniel Vetter, Copyright © 2013 Intel Corporation
|
||||
|
||||
|
@ -129,7 +129,7 @@ Architectural changes
|
||||
---------------------
|
||||
|
||||
DevFS has been obsoleted in favour of udev
|
||||
(http://www.kernel.org/pub/linux/utils/kernel/hotplug/)
|
||||
(https://www.kernel.org/pub/linux/utils/kernel/hotplug/)
|
||||
|
||||
32-bit UID support is now in place. Have fun!
|
||||
|
||||
@ -421,7 +421,7 @@ Intel P6 microcode
|
||||
udev
|
||||
----
|
||||
|
||||
- <http://www.freedesktop.org/software/systemd/man/udev.html>
|
||||
- <https://www.freedesktop.org/software/systemd/man/udev.html>
|
||||
|
||||
FUSE
|
||||
----
|
||||
@ -474,4 +474,4 @@ Kernel documentation
|
||||
Sphinx
|
||||
------
|
||||
|
||||
- <http://www.sphinx-doc.org/>
|
||||
- <https://www.sphinx-doc.org/>
|
||||
|
@ -32,7 +32,7 @@ Linux distributions for a long time. Search for ``clang-format`` in
|
||||
your repositories. Otherwise, you can either download pre-built
|
||||
LLVM/clang binaries or build the source code from:
|
||||
|
||||
http://releases.llvm.org/download.html
|
||||
https://releases.llvm.org/download.html
|
||||
|
||||
See more information about the tool at:
|
||||
|
||||
|
@ -1129,7 +1129,7 @@ Addison-Wesley, Inc., 1999.
|
||||
ISBN 0-201-61586-X.
|
||||
|
||||
GNU manuals - where in compliance with K&R and this text - for cpp, gcc,
|
||||
gcc internals and indent, all available from http://www.gnu.org/manual/
|
||||
gcc internals and indent, all available from https://www.gnu.org/manual/
|
||||
|
||||
WG14 is the international standardization working group for the programming
|
||||
language C, URL: http://www.open-std.org/JTC1/SC22/WG14/
|
||||
|
@ -597,7 +597,7 @@ For more details on what this should all look like, please see the
|
||||
ChangeLog section of the document:
|
||||
|
||||
"The Perfect Patch"
|
||||
http://www.ozlabs.org/~akpm/stuff/tpp.txt
|
||||
https://www.ozlabs.org/~akpm/stuff/tpp.txt
|
||||
|
||||
|
||||
All of these things are sometimes very hard to do. It can take years to
|
||||
|
@ -98,7 +98,7 @@ On-line docs
|
||||
* Title: **Linux Device Drivers, Third Edition**
|
||||
|
||||
:Author: Jonathan Corbet, Alessandro Rubini, Greg Kroah-Hartman
|
||||
:URL: http://lwn.net/Kernel/LDD3/
|
||||
:URL: https://lwn.net/Kernel/LDD3/
|
||||
:Date: 2005
|
||||
:Description: A 600-page book covering the (2.6.10) driver
|
||||
programming API and kernel hacking in general. Available under the
|
||||
@ -129,7 +129,7 @@ On-line docs
|
||||
* Title: **Linux Kernel Module Programming Guide**
|
||||
|
||||
:Author: Ori Pomerantz.
|
||||
:URL: http://tldp.org/LDP/lkmpg/2.6/html/index.html
|
||||
:URL: https://tldp.org/LDP/lkmpg/2.6/html/index.html
|
||||
:Date: 2001
|
||||
:Keywords: modules, GPL book, /proc, ioctls, system calls,
|
||||
interrupt handlers .
|
||||
@ -244,7 +244,7 @@ On-line docs
|
||||
* Title: **I/O Event Handling Under Linux**
|
||||
|
||||
:Author: Richard Gooch.
|
||||
:URL: http://web.mit.edu/~yandros/doc/io-events.html
|
||||
:URL: https://web.mit.edu/~yandros/doc/io-events.html
|
||||
:Date: 1999
|
||||
:Keywords: IO, I/O, select(2), poll(2), FDs, aio_read(2), readiness
|
||||
event queues.
|
||||
@ -295,7 +295,7 @@ On-line docs
|
||||
* Title: **Design and Implementation of the Second Extended Filesystem**
|
||||
|
||||
:Author: Rémy Card, Theodore Ts'o, Stephen Tweedie.
|
||||
:URL: http://web.mit.edu/tytso/www/linux/ext2intro.html
|
||||
:URL: https://web.mit.edu/tytso/www/linux/ext2intro.html
|
||||
:Date: 1998
|
||||
:Keywords: ext2, linux fs history, inode, directory, link, devices,
|
||||
VFS, physical structure, performance, benchmarks, ext2fs library,
|
||||
@ -322,7 +322,7 @@ On-line docs
|
||||
* Title: **Linux Kernel Hackers' Guide**
|
||||
|
||||
:Author: Michael K. Johnson.
|
||||
:URL: http://www.tldp.org/LDP/khg/HyperNews/get/khg.html
|
||||
:URL: https://www.tldp.org/LDP/khg/HyperNews/get/khg.html
|
||||
:Date: 1997
|
||||
:Keywords: device drivers, files, VFS, kernel interface, character vs
|
||||
block devices, hardware interrupts, scsi, DMA, access to user memory,
|
||||
@ -375,7 +375,7 @@ On-line docs
|
||||
* Title: **Dissecting Interrupts and Browsing DMA**
|
||||
|
||||
:Author: Alessandro Rubini and Georg v. Zezschwitz.
|
||||
:URL: http://www.linuxjournal.com/article.php?sid=1222
|
||||
:URL: https://www.linuxjournal.com/article.php?sid=1222
|
||||
:Date: 1996
|
||||
:Keywords: interrupts, irqs, DMA, bottom halves, task queues.
|
||||
:Description: Linux Journal Kernel Korner article.
|
||||
@ -391,7 +391,7 @@ On-line docs
|
||||
* Title: **Device Drivers Concluded**
|
||||
|
||||
:Author: Georg v. Zezschwitz.
|
||||
:URL: http://www.linuxjournal.com/article.php?sid=1287
|
||||
:URL: https://www.linuxjournal.com/article.php?sid=1287
|
||||
:Date: 1996
|
||||
:Keywords: address spaces, pages, pagination, page management,
|
||||
demand loading, swapping, memory protection, memory mapping, mmap,
|
||||
@ -405,7 +405,7 @@ On-line docs
|
||||
* Title: **Network Buffers And Memory Management**
|
||||
|
||||
:Author: Alan Cox.
|
||||
:URL: http://www.linuxjournal.com/article.php?sid=1312
|
||||
:URL: https://www.linuxjournal.com/article.php?sid=1312
|
||||
:Date: 1996
|
||||
:Keywords: sk_buffs, network devices, protocol/link layer
|
||||
variables, network devices flags, transmit, receive,
|
||||
@ -418,7 +418,7 @@ On-line docs
|
||||
* Title: **Analysis of the Ext2fs structure**
|
||||
|
||||
:Author: Louis-Dominique Dubeau.
|
||||
:URL: http://teaching.csse.uwa.edu.au/units/CITS2002/fs-ext2/
|
||||
:URL: https://teaching.csse.uwa.edu.au/units/CITS2002/fs-ext2/
|
||||
:Date: 1994
|
||||
:Keywords: ext2, filesystem, ext2fs.
|
||||
:Description: Description of ext2's blocks, directories, inodes,
|
||||
@ -480,7 +480,7 @@ Published books
|
||||
:ISBN: 0-596-00590-3
|
||||
:Notes: Further information in
|
||||
http://www.oreilly.com/catalog/linuxdrive3/
|
||||
PDF format, URL: http://lwn.net/Kernel/LDD3/
|
||||
PDF format, URL: https://lwn.net/Kernel/LDD3/
|
||||
|
||||
* Title: **Linux Kernel Internals**
|
||||
|
||||
@ -561,7 +561,7 @@ Miscellaneous
|
||||
|
||||
* Name: **Linux Weekly News**
|
||||
|
||||
:URL: http://lwn.net
|
||||
:URL: https://lwn.net
|
||||
:Keywords: latest kernel news.
|
||||
:Description: The title says it all. There's a fixed kernel section
|
||||
summarizing developers' work, bug fixes, new features and versions
|
||||
@ -570,7 +570,7 @@ Miscellaneous
|
||||
* Name: **The home page of Linux-MM**
|
||||
|
||||
:Author: The Linux-MM team.
|
||||
:URL: http://linux-mm.org/
|
||||
:URL: https://linux-mm.org/
|
||||
:Keywords: memory management, Linux-MM, mm patches, TODO, docs,
|
||||
mailing list.
|
||||
:Description: Site devoted to Linux Memory Management development.
|
||||
@ -579,7 +579,7 @@ Miscellaneous
|
||||
|
||||
* Name: **Kernel Newbies IRC Channel and Website**
|
||||
|
||||
:URL: http://www.kernelnewbies.org
|
||||
:URL: https://www.kernelnewbies.org
|
||||
:Keywords: IRC, newbies, channel, asking doubts.
|
||||
:Description: #kernelnewbies on irc.oftc.net.
|
||||
#kernelnewbies is an IRC network dedicated to the 'newbie'
|
||||
@ -605,4 +605,4 @@ Miscellaneous
|
||||
Document last updated on Tue 2016-Sep-20
|
||||
|
||||
This document is based on:
|
||||
http://www.dit.upm.es/~jmseyas/linux/kernel/hackers-docs.html
|
||||
https://www.dit.upm.es/~jmseyas/linux/kernel/hackers-docs.html
|
||||
|
@ -462,7 +462,7 @@ geographical region, and open/proprietary hardware considerations.
|
||||
.. _`Nitrokey Start`: https://shop.nitrokey.com/shop/product/nitrokey-start-6
|
||||
.. _`Nitrokey Pro 2`: https://shop.nitrokey.com/shop/product/nitrokey-pro-2-3
|
||||
.. _`Yubikey 5`: https://www.yubico.com/products/yubikey-5-overview/
|
||||
.. _Gnuk: http://www.fsij.org/doc-gnuk/
|
||||
.. _Gnuk: https://www.fsij.org/doc-gnuk/
|
||||
.. _`LWN has a good review`: https://lwn.net/Articles/736231/
|
||||
.. _`qualify for a free Nitrokey Start`: https://www.kernel.org/nitrokey-digital-tokens-for-kernel-developers.html
|
||||
|
||||
|
@ -5,8 +5,8 @@ Submitting Drivers For The Linux Kernel
|
||||
|
||||
This document is intended to explain how to submit device drivers to the
|
||||
various kernel trees. Note that if you are interested in video card drivers
|
||||
you should probably talk to XFree86 (http://www.xfree86.org/) and/or X.Org
|
||||
(http://x.org/) instead.
|
||||
you should probably talk to XFree86 (https://www.xfree86.org/) and/or X.Org
|
||||
(https://x.org/) instead.
|
||||
|
||||
.. note::
|
||||
|
||||
@ -25,7 +25,7 @@ Allocating Device Numbers
|
||||
|
||||
Major and minor numbers for block and character devices are allocated
|
||||
by the Linux assigned name and number authority (currently this is
|
||||
Torben Mathiasen). The site is http://www.lanana.org/. This
|
||||
Torben Mathiasen). The site is https://www.lanana.org/. This
|
||||
also deals with allocating numbers for devices that are not going to
|
||||
be submitted to the mainstream kernel.
|
||||
See :ref:`Documentation/admin-guide/devices.rst <admin_devices>`
|
||||
@ -155,30 +155,30 @@ Linux kernel master tree:
|
||||
where *country_code* == your country code, such as
|
||||
**us**, **uk**, **fr**, etc.
|
||||
|
||||
http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git
|
||||
https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git
|
||||
|
||||
Linux kernel mailing list:
|
||||
linux-kernel@vger.kernel.org
|
||||
[mail majordomo@vger.kernel.org to subscribe]
|
||||
|
||||
Linux Device Drivers, Third Edition (covers 2.6.10):
|
||||
http://lwn.net/Kernel/LDD3/ (free version)
|
||||
https://lwn.net/Kernel/LDD3/ (free version)
|
||||
|
||||
LWN.net:
|
||||
Weekly summary of kernel development activity - http://lwn.net/
|
||||
Weekly summary of kernel development activity - https://lwn.net/
|
||||
|
||||
2.6 API changes:
|
||||
|
||||
http://lwn.net/Articles/2.6-kernel-api/
|
||||
https://lwn.net/Articles/2.6-kernel-api/
|
||||
|
||||
Porting drivers from prior kernels to 2.6:
|
||||
|
||||
http://lwn.net/Articles/driver-porting/
|
||||
https://lwn.net/Articles/driver-porting/
|
||||
|
||||
KernelNewbies:
|
||||
Documentation and assistance for new kernel programmers
|
||||
|
||||
http://kernelnewbies.org/
|
||||
https://kernelnewbies.org/
|
||||
|
||||
Linux USB project:
|
||||
http://www.linux-usb.org/
|
||||
@ -187,7 +187,7 @@ How to NOT write kernel driver by Arjan van de Ven:
|
||||
http://www.fenrus.org/how-to-not-write-a-device-driver-paper.pdf
|
||||
|
||||
Kernel Janitor:
|
||||
http://kernelnewbies.org/KernelJanitors
|
||||
https://kernelnewbies.org/KernelJanitors
|
||||
|
||||
GIT, Fast Version Control System:
|
||||
http://git-scm.com/
|
||||
https://git-scm.com/
|
||||
|
@ -94,7 +94,7 @@ individual patches which modify things in logical stages; see
|
||||
very important if you want your patch accepted.
|
||||
|
||||
If you're using ``git``, ``git rebase -i`` can help you with this process. If
|
||||
you're not using ``git``, ``quilt`` <http://savannah.nongnu.org/projects/quilt>
|
||||
you're not using ``git``, ``quilt`` <https://savannah.nongnu.org/projects/quilt>
|
||||
is another popular alternative.
|
||||
|
||||
.. _describe_changes:
|
||||
@ -892,7 +892,7 @@ References
|
||||
----------
|
||||
|
||||
Andrew Morton, "The perfect patch" (tpp).
|
||||
<http://www.ozlabs.org/~akpm/stuff/tpp.txt>
|
||||
<https://www.ozlabs.org/~akpm/stuff/tpp.txt>
|
||||
|
||||
Jeff Garzik, "Linux kernel patch submission format".
|
||||
<https://web.archive.org/web/20180829112450/http://linux.yyz.us/patch-format.html>
|
||||
|
Loading…
Reference in New Issue
Block a user