1.. include:: ../disclaimer-sp.rst
2
3:Original: :ref:`Documentation/process/kernel-docs.rst <kernel_docs>`
4:Translator: Carlos Bilbao <carlos.bilbao.osdev@gmail.com>
5
6.. _sp_kernel_docs:
7
8��ndice de documentaci��n adicional del kernel
9============================================
10
11La necesidad de un documento como este se hizo evidente en la lista de
12correo de linux-kernel cuando las mismas preguntas, solicitando sugerencias
13e informaci��n, aparecieron una y otra vez.
14
15Afortunadamente, a medida que m��s y m��s gente accede a GNU/Linux, m��s
16desarrolladores se interesan por el kernel. Sin embargo, leer las fuentes
17no siempre es suficiente. Es f��cil entender el c��digo, pero se pierden los
18conceptos, la filosof��a y decisiones de dise��o detr��s de dicho c��digo.
19
20Desafortunadamente, no existen muchos documentos disponibles para que los
21principiantes comiencen. Y, aunque existieran, no habr��a ning��n lugar
22"conocido" que les pudiera seguir la pista. Estas l��neas tratan de cubrir
23esta carencia.
24
25POR FAVOR, si conoce alg��n documento que no figura aqu��, o si escribe un
26nuevo documento, incluya una referencia aqu��, siguiendo el proceso de env��o
27de parches del kernel. Cualquier correcci��n, idea o comentario tambi��n es
28bienvenida.
29
30Todos los documentos se catalogan con los siguientes campos: el "T��tulo",
31el "Autor"/es, la "URL" donde se encuentran, algunas "Palabras clave"
32��tiles para buscar temas espec��ficos, y una breve "Descripci��n" del
33documento en cuesti��n.
34
35.. note::
36
37   Los documentos de cada secci��n en este documento est��n ordenados por su
38   fecha de publicaci��n, del m��s reciente al m��s antiguo. Los maintainers
39   deben ir retirando recursos obsoletos o anticuados.
40
41Documentos en el ��rbol del kernel Linux
42-----------------------------------------
43
44Los libros de Sphinx deben compilarse con ``make {htmldocs | pdfdocs | epubdocs}``.
45
46    * T��tulo: **linux/Documentation**
47
48      :Autor: Many.
49      :Ubicaci��n: Documentation/
50      :Palabras Clave: archivos de texto, Sphinx.
51      :Descripci��n: Documentaci��n que viene con las fuentes del kernel,
52        dentro del directorio Documentation. Algunas p��ginas de este documento
53        (incluido este documento en s��) se han trasladado all��, y podr��an
54        estar m��s actualizadas que la versi��n web.
55
56Documentos en l��nea
57-------------------
58
59    * T��tulo: **Linux Kernel Mailing List Glossary**
60
61      :Autor: various
62      :URL: https://kernelnewbies.org/KernelGlossary
63      :Fecha: rolling version
64      :Palabras Clave: glosario terminos, linux-kernel.
65      :Descripci��n: De la Introducci��n: "This glossary is intended as
66        a brief description of some of the acronyms and terms you may hear
67        during discussion of the Linux kernel".
68
69    * T��tulo: **The Linux Kernel Module Programming Guide**
70
71      :Autor: Peter Jay Salzman, Michael Burian, Ori Pomerantz, Bob Mottram,
72        Jim Huang.
73      :URL: https://sysprog21.github.io/lkmpg/
74      :Fecha: 2021
75      :Palabras Clave: modules, GPL book, /proc, ioctls, system calls,
76        interrupt handlers, llamadas al sistema, interrupciones.
77      :Descripci��n: Un muy buen libro GPL sobre el tema de la programaci��n
78        de m��dulos. Muchos ejemplos. Actualmente la nueva versi��n est��
79        siendo mantenida activamente ent https://github.com/sysprog21/lkmpg.
80
81Libros publicados
82-----------------
83
84    * T��tulo: **Linux Kernel Programming: A Comprehensive Guide to Kernel Internals, Writing Kernel Modules, and Kernel Synchronization**
85
86      :Autor: Kaiwan N. Billimoria
87      :Publica: Packt Publishing Ltd
88      :Fecha: 2021
89      :Paginas: 754
90      :ISBN: 978-1789953435
91
92    * T��tulo: **Linux Kernel Development, 3rd Edition**
93
94      :Autor: Robert Love
95      :Publica: Addison-Wesley
96      :Fecha: July, 2010
97      :Paginas: 440
98      :ISBN: 978-0672329463
99      :Notas: Libro fundacional
100
101.. _sp_ldd3_published:
102
103    * T��tulo: **Linux Device Drivers, 3rd Edition**
104
105      :Authors: Jonathan Corbet, Alessandro Rubini, and Greg Kroah-Hartman
106      :Publica: O'Reilly & Associates
107      :Fecha: 2005
108      :Paginas: 636
109      :ISBN: 0-596-00590-3
110      :Notas: Libro fundacional. M��s informaci��n en
111        http://www.oreilly.com/catalog/linuxdrive3/
112        formato PDF, URL: https://lwn.net/Kernel/LDD3/
113
114    * T��tulo: **The Design of the UNIX Operating System**
115
116      :Autor: Maurice J. Bach
117      :Publica: Prentice Hall
118      :Fecha: 1986
119      :Paginas: 471
120      :ISBN: 0-13-201757-1
121      :Notas: Libro fundacional
122
123Recursos varios
124---------------
125
126    * T��tulo: **Cross-Referencing Linux**
127
128      :URL: https://elixir.bootlin.com/
129      :Palabras Clave: Browsing source code.
130      :Descripci��n: Otro navegador de c��digo fuente del kernel Linux que se
131        encuentra en la web.  Muchas referencias cruzadas a variables y
132        funciones. Puedes ver d��nde se definen y d��nde se utilizan.
133
134    * T��tulo: **Linux Weekly News**
135
136      :URL: https://lwn.net
137      :Palabras Clave: latest kernel news, noticias del kernel Linux.
138      :Descripci��n: El t��tulo lo dice todo (Noticias Semanales de Linux).
139        Hay una secci��n fija sobre el kernel, resumiendo el trabajo de sus
140        desarrolladores, correcciones de errores, nuevas funciones y
141        versiones, producido durante la semana.
142
143    * T��tulo: **The home page of Linux-MM**
144
145      :Autor: The Linux-MM team.
146      :URL: https://linux-mm.org/
147      :Palabras Clave: memory management, Linux-MM, mm patches, TODO, docs,
148        mailing list, administraci��n de memoria, Linux-MM, parches mm, listas
149        de correo.
150      :Descripci��n: Sitio dedicado al desarrollo de la gesti��n de memoria
151        de Linux. Parches relacionados con la memoria, HOWTOs, enlaces,
152        desarrolladores de mm... ��Si est�� interesado en el desarrollo de la
153        gesti��n de memoria no te lo pierdas!
154
155    * T��tulo: **Kernel Newbies IRC Channel and Website**
156
157      :URL: https://www.kernelnewbies.org
158      :Palabras Clave: IRC, newbies, channel, asking doubts, canal, dudas,
159        novatos, preguntar.
160      :Descripci��n: #kernelnewbies en irc.oftc.net.
161        #kernelnewbies es una red de IRC dedicada al hacker del kernel
162        'novato'. La audiencia se compone principalmente de personas que
163        quieren aprender sobre el kernel, trabajar en proyectos del kernel
164        o hackers profesionales del kernel que quieren ayudar a la gente
165        menos experimentada.
166        #kernelnewbies es parte de la red OFTC IRC.
167        Pruebe con irc.oftc.net como su servidor y luego haga /join
168        #kernelnewbies.
169        El sitio web kernelnewbies tambi��n alberga art��culos, documentos, FAQs...
170
171    * T��tulo: **linux-kernel mailing list archives and search engines**
172
173      :URL: http://vger.kernel.org/vger-lists.html
174      :URL: http://www.uwsg.indiana.edu/hypermail/linux/kernel/index.html
175      :URL: http://groups.google.com/group/mlist.linux.kernel
176      :Palabras Clave: linux-kernel, archives, buscar, search, archivos.
177      :Descripci��n: Algunos de los archivadores de listas de correo del
178        kernel de Linux. Si usted tiene uno mejor/otro, por favor h��gamelo
179        saber.
180
181-------
182
183Este documento se basaba originalmente en:
184
185  https://www.dit.upm.es/~jmseyas/linux/kernel/hackers-docs.html
186
187escrito por Juan-Mariano de Goyenche
188