€•Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒEnglish”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ/process/coding-style”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Simplified)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/zh_CN/process/coding-style”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/zh_TW/process/coding-style”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/it_IT/process/coding-style”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/ja_JP/process/coding-style”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/ko_KR/process/coding-style”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/pt_BR/process/coding-style”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒSpanish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒwarning”“”)”}”(hX?Si tiene alguna duda sobre la exactitud del contenido de esta traducción, la única referencia válida es la documentación oficial en inglés. Además, por defecto, los enlaces a documentos redirigen a la documentación en inglés, incluso si existe una versión traducida. Consulte el índice para más información.”h]”hŒ paragraph”“”)”}”(hX?Si tiene alguna duda sobre la exactitud del contenido de esta traducción, la única referencia válida es la documentación oficial en inglés. Además, por defecto, los enlaces a documentos redirigen a la documentación en inglés, incluso si existe una versión traducida. Consulte el índice para más información.”h]”hX?Si tiene alguna duda sobre la exactitud del contenido de esta traducción, la única referencia válida es la documentación oficial en inglés. Además, por defecto, los enlaces a documentos redirigen a la documentación en inglés, incluso si existe una versión traducida. Consulte el índice para más información.”…””}”(hh½h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³Œ2Documentation/translations/sp_SP/disclaimer-sp.rst”h´Khh·ubah}”(h]”h ]”h"]”h$]”h&]”uh1hµhhh²hh³hËh´NubhŒ field_list”“”)”}”(hhh]”(hŒfield”“”)”}”(hhh]”(hŒ field_name”“”)”}”(hŒOriginal”h]”hŒOriginal”…””}”(hhÞh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜhhÙh³ŒU/var/lib/git/docbuild/linux/Documentation/translations/sp_SP/process/coding-style.rst”h´KubhŒ field_body”“”)”}”(hŒA:ref:`Documentation/process/coding-style.rst `”h]”h¼)”}”(hhñh]”h)”}”(hhñh]”hŒinline”“”)”}”(hhñh]”hŒ&Documentation/process/coding-style.rst”…””}”(hhûh²hh³Nh´Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-ref”eh"]”h$]”h&]”uh1hùhhöubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œ'translations/sp_SP/process/coding-style”Œ refdomain”jŒreftype”Œref”Œ refexplicit”ˆŒrefwarn”ˆŒ reftarget”Œsubmittingpatches”uh1hh³hìh´Khhóubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Khhïubah}”(h]”h ]”h"]”h$]”h&]”uh1híhhÙubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×h³hìh´KhhÔh²hubhØ)”}”(hhh]”(hÝ)”}”(hŒ Translator”h]”hŒ Translator”…””}”(hj/h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜhj,h³hìh´Kubhî)”}”(hŒ.Carlos Bilbao ”h]”h¼)”}”(hŒ-Carlos Bilbao ”h]”(hŒCarlos Bilbao <”…””}”(hjAh²hh³Nh´NubhŒ reference”“”)”}”(hŒcarlos.bilbao.osdev@gmail.com”h]”hŒcarlos.bilbao.osdev@gmail.com”…””}”(hjKh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ$mailto:carlos.bilbao.osdev@gmail.com”uh1jIhjAubhŒ>”…””}”(hjAh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Khj=ubah}”(h]”h ]”h"]”h$]”h&]”uh1híhj,ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×h³hìh´KhhÔh²hubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÒhhh²hh³hìh´KubhŒtarget”“”)”}”(hŒ.. _sp_codingstyle:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œsp-codingstyle”uh1jwh´Khhh²hh³hìubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ%Estilo en el código del kernel Linux”h]”hŒ%Estilo en el código del kernel Linux”…””}”(hjŒh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj‡h²hh³hìh´K ubh¼)”}”(hXdEste es un breve documento que describe el estilo preferido en el código del kernel Linux. El estilo de código es muy personal y no **forzaré** mi puntos de vista sobre nadie, pero esto vale para todo lo que tengo que mantener, y preferiría que para la mayoría de otras cosas también. Por favor, por lo menos considere los argumentos expuestos aquí.”h]”(hŒ†Este es un breve documento que describe el estilo preferido en el código del kernel Linux. El estilo de código es muy personal y no ”…””}”(hjšh²hh³Nh´NubhŒstrong”“”)”}”(hŒ **forzaré**”h]”hŒforzaré”…””}”(hj¤h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¢hjšubhŒÒ mi puntos de vista sobre nadie, pero esto vale para todo lo que tengo que mantener, y preferiría que para la mayoría de otras cosas también. Por favor, por lo menos considere los argumentos expuestos aquí.”…””}”(hjšh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K hj‡h²hubh¼)”}”(hŒ†En primer lugar, sugeriría imprimir una copia de los estándares de código GNU, y NO leerlo. Quémelos, es un gran gesto simbólico.”h]”hŒ†En primer lugar, sugeriría imprimir una copia de los estándares de código GNU, y NO leerlo. Quémelos, es un gran gesto simbólico.”…””}”(hj¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Khj‡h²hubh¼)”}”(hŒDe todos modos, aquí va:”h]”hŒDe todos modos, aquí va:”…””}”(hjÊh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Khj‡h²hubj†)”}”(hhh]”(j‹)”}”(hŒ 1) Sangría”h]”hŒ 1) Sangría”…””}”(hjÛh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjØh²hh³hìh´Kubh¼)”}”(hXLas tabulaciones tienen 8 caracteres y, por lo tanto, las sangrías también tienen 8 caracteres. Hay movimientos heréticos que intentan hacer sangría de 4 (¡o incluso 2!) caracteres de longitud, y eso es similar a tratar de definir el valor de PI como 3.”h]”hXLas tabulaciones tienen 8 caracteres y, por lo tanto, las sangrías también tienen 8 caracteres. Hay movimientos heréticos que intentan hacer sangría de 4 (¡o incluso 2!) caracteres de longitud, y eso es similar a tratar de definir el valor de PI como 3.”…””}”(hjéh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KhjØh²hubh¼)”}”(hX"Justificación: La idea detrás de la sangría es definir claramente dónde comienza y termina un bloque de control. Especialmente, cuando ha estado buscando en su pantalla durante 20 horas seguidas, le resultará mucho más fácil ver cómo funciona la sangría si tiene sangrías grandes.”h]”hX"Justificación: La idea detrás de la sangría es definir claramente dónde comienza y termina un bloque de control. Especialmente, cuando ha estado buscando en su pantalla durante 20 horas seguidas, le resultará mucho más fácil ver cómo funciona la sangría si tiene sangrías grandes.”…””}”(hj÷h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KhjØh²hubh¼)”}”(hX@Bueno, algunas personas dirán que tener sangrías de 8 caracteres hace que el código se mueva demasiado a la derecha y dificulta la lectura en una pantalla de terminal de 80 caracteres. La respuesta a eso es que si necesita más de 3 niveles de sangría, está en apuros de todos modos y debería arreglar su programa.”h]”hX@Bueno, algunas personas dirán que tener sangrías de 8 caracteres hace que el código se mueva demasiado a la derecha y dificulta la lectura en una pantalla de terminal de 80 caracteres. La respuesta a eso es que si necesita más de 3 niveles de sangría, está en apuros de todos modos y debería arreglar su programa.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K$hjØh²hubh¼)”}”(hŒÅEn resumen, las sangrías de 8 caracteres facilitan la lectura y tienen la ventaja añadida de advertirle cuando está anidando sus funciones demasiado profundo. Preste atención a esa advertencia.”h]”hŒÅEn resumen, las sangrías de 8 caracteres facilitan la lectura y tienen la ventaja añadida de advertirle cuando está anidando sus funciones demasiado profundo. Preste atención a esa advertencia.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K*hjØh²hubh¼)”}”(hXLa forma preferida de facilitar múltiples niveles de sangría en una declaración de switch es para alinear el ``switch`` y sus etiquetas ``case`` subordinadas en la misma columna, en lugar de hacer ``doble sangría`` (``double-indenting``) en etiquetas ``case``. Por ejemplo:”h]”(hŒpLa forma preferida de facilitar múltiples niveles de sangría en una declaración de switch es para alinear el ”…””}”(hj!h²hh³Nh´NubhŒliteral”“”)”}”(hŒ ``switch``”h]”hŒswitch”…””}”(hj+h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj!ubhŒ y sus etiquetas ”…””}”(hj!h²hh³Nh´Nubj*)”}”(hŒ``case``”h]”hŒcase”…””}”(hj=h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj!ubhŒ5 subordinadas en la misma columna, en lugar de hacer ”…””}”(hj!h²hh³Nh´Nubj*)”}”(hŒ``doble sangría``”h]”hŒdoble sangría”…””}”(hjOh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj!ubhŒ (”…””}”(hj!h²hh³Nh´Nubj*)”}”(hŒ``double-indenting``”h]”hŒdouble-indenting”…””}”(hjah²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj!ubhŒ) en etiquetas ”…””}”(hj!h²hh³Nh´Nubj*)”}”(hŒ``case``”h]”hŒcase”…””}”(hjsh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj!ubhŒ. Por ejemplo:”…””}”(hj!h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K.hjØh²hubhŒ literal_block”“”)”}”(hŒÖswitch (suffix) { case 'G': case 'g': mem <<= 30; break; case 'M': case 'm': mem <<= 20; break; case 'K': case 'k': mem <<= 10; fallthrough; default: break; }”h]”hŒÖswitch (suffix) { case 'G': case 'g': mem <<= 30; break; case 'M': case 'm': mem <<= 20; break; case 'K': case 'k': mem <<= 10; fallthrough; default: break; }”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”Œforce”‰Œlanguage”Œc”Œhighlight_args”}”uh1j‹h³hìh´K3hjØh²hubh¼)”}”(hŒTNo ponga varias declaraciones en una sola línea a menos que tenga algo que ocultar:”h]”hŒTNo ponga varias declaraciones en una sola línea a menos que tenga algo que ocultar:”…””}”(hj¢h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KFhjØh²hubjŒ)”}”(hŒ*if (condición) haz_esto; haz_otra_cosa;”h]”hŒ*if (condición) haz_esto; haz_otra_cosa;”…””}”hj°sbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´KIhjØh²hubh¼)”}”(hŒ*No use comas para evitar el uso de llaves:”h]”hŒ*No use comas para evitar el uso de llaves:”…””}”(hj¿h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KNhjØh²hubjŒ)”}”(hŒ.if (condición) haz_esto(), haz_eso();”h]”hŒ.if (condición) haz_esto(), haz_eso();”…””}”hjÍsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´KPhjØh²hubh¼)”}”(hŒ1Siempre use llaves para múltiples declaraciones:”h]”hŒ1Siempre use llaves para múltiples declaraciones:”…””}”(hjÜh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KUhjØh²hubjŒ)”}”(hŒ:if (condición) { haz_esto(); haz_eso(); }”h]”hŒ:if (condición) { haz_esto(); haz_eso(); }”…””}”hjêsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´KWhjØh²hubh¼)”}”(hŒ‰Tampoco ponga varias asignaciones en una sola línea. El estilo de código del kernel es súper simple. Evite las expresiones engañosas.”h]”hŒ‰Tampoco ponga varias asignaciones en una sola línea. El estilo de código del kernel es súper simple. Evite las expresiones engañosas.”…””}”(hjùh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K^hjØh²hubh¼)”}”(hŒ£Aparte de los comentarios, la documentación y excepto en Kconfig, los espacios nunca se utilizan para la sangría, y el ejemplo anterior se rompe deliberadamente.”h]”hŒ£Aparte de los comentarios, la documentación y excepto en Kconfig, los espacios nunca se utilizan para la sangría, y el ejemplo anterior se rompe deliberadamente.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KbhjØh²hubh¼)”}”(hŒOConsiga un editor decente y no deje espacios en blanco al final de las líneas.”h]”hŒOConsiga un editor decente y no deje espacios en blanco al final de las líneas.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KfhjØh²hubeh}”(h]”Œsangria”ah ]”h"]”Œ 1) sangría”ah$]”h&]”uh1j…hj‡h²hh³hìh´Kubj†)”}”(hhh]”(j‹)”}”(hŒ%2) Rompiendo líneas y strings largos”h]”hŒ%2) Rompiendo líneas y strings largos”…””}”(hj.h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj+h²hh³hìh´Kjubh¼)”}”(hŒ{El estilo de código tiene todo que ver con la legibilidad y la mantenibilidad usando herramientas disponibles comúnmente.”h]”hŒ{El estilo de código tiene todo que ver con la legibilidad y la mantenibilidad usando herramientas disponibles comúnmente.”…””}”(hj<h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Klhj+h²hubh¼)”}”(hŒIEl límite preferido en la longitud de una sola línea es de 80 columnas.”h]”hŒIEl límite preferido en la longitud de una sola línea es de 80 columnas.”…””}”(hjJh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kohj+h²hubh¼)”}”(hŒ«Las declaraciones de más de 80 columnas deben dividirse en partes, a menos que exceder las 80 columnas aumente significativamente la legibilidad y no oculte información.”h]”hŒ«Las declaraciones de más de 80 columnas deben dividirse en partes, a menos que exceder las 80 columnas aumente significativamente la legibilidad y no oculte información.”…””}”(hjXh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kqhj+h²hubh¼)”}”(hŒÄLos descendientes siempre son sustancialmente más cortos que el padre y se colocan sustancialmente a la derecha. Un estilo muy usado es alinear descendientes a un paréntesis de función abierto.”h]”hŒÄLos descendientes siempre son sustancialmente más cortos que el padre y se colocan sustancialmente a la derecha. Un estilo muy usado es alinear descendientes a un paréntesis de función abierto.”…””}”(hjfh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kuhj+h²hubh¼)”}”(hŒ`Estas mismas reglas se aplican a los encabezados de funciones con una larga lista de argumentos.”h]”hŒ`Estas mismas reglas se aplican a los encabezados de funciones con una larga lista de argumentos.”…””}”(hjth²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kyhj+h²hubh¼)”}”(hŒ‡Sin embargo, nunca rompa los strings visibles para el usuario, como los mensajes printk, porque eso rompe la capacidad de grep a estos.”h]”hŒ‡Sin embargo, nunca rompa los strings visibles para el usuario, como los mensajes printk, porque eso rompe la capacidad de grep a estos.”…””}”(hj‚h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K|hj+h²hubeh}”(h]”Œ!rompiendo-lineas-y-strings-largos”ah ]”h"]”Œ%2) rompiendo líneas y strings largos”ah$]”h&]”uh1j…hj‡h²hh³hìh´Kjubj†)”}”(hhh]”(j‹)”}”(hŒ#3) Colocación de llaves y espacios”h]”hŒ#3) Colocación de llaves y espacios”…””}”(hj›h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj˜h²hh³hìh´Kubh¼)”}”(hXqEl otro problema que siempre surge en el estilo C es la colocación de llaves. A diferencia del tamaño de la sangría, existen pocas razones técnicas para elegir una estrategia de ubicación sobre la otra, pero la forma preferida, como mostraron los profetas Kernighan y Ritchie, es poner la llave de apertura en la línea, y colocar la llave de cierre primero, así:”h]”hXqEl otro problema que siempre surge en el estilo C es la colocación de llaves. A diferencia del tamaño de la sangría, existen pocas razones técnicas para elegir una estrategia de ubicación sobre la otra, pero la forma preferida, como mostraron los profetas Kernighan y Ritchie, es poner la llave de apertura en la línea, y colocar la llave de cierre primero, así:”…””}”(hj©h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kƒhj˜h²hubjŒ)”}”(hŒ&if (x es verdad) { hacemos y }”h]”hŒ&if (x es verdad) { hacemos y }”…””}”hj·sbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´KŠhj˜h²hubh¼)”}”(hŒsEsto se aplica a todos los bloques de declaraciones que no son funciones (if, switch, for, while, do). Por ejemplo:”h]”hŒsEsto se aplica a todos los bloques de declaraciones que no son funciones (if, switch, for, while, do). Por ejemplo:”…””}”(hjÆh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Khj˜h²hubjŒ)”}”(hŒ¬switch (action) { case KOBJ_ADD: return "add"; case KOBJ_REMOVE: return "remove"; case KOBJ_CHANGE: return "change"; default: return NULL; }”h]”hŒ¬switch (action) { case KOBJ_ADD: return "add"; case KOBJ_REMOVE: return "remove"; case KOBJ_CHANGE: return "change"; default: return NULL; }”…””}”hjÔsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´K“hj˜h²hubh¼)”}”(hŒ€Sin embargo, hay un caso especial, a saber, las funciones: tienen la llave de apertura al comienzo de la siguiente línea, así:”h]”hŒ€Sin embargo, hay un caso especial, a saber, las funciones: tienen la llave de apertura al comienzo de la siguiente línea, así:”…””}”(hjãh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K hj˜h²hubjŒ)”}”(hŒ4int funcion(int x) { cuerpo de la función }”h]”hŒ4int funcion(int x) { cuerpo de la función }”…””}”hjñsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´K£hj˜h²hubh¼)”}”(hX Gente hereje de todo el mundo ha afirmado que esta inconsistencia es... bueno... inconsistente, pero todas las personas sensatas saben que (a) K&R tienen **razón** y (b) K&R tienen razón. Además, las funciones son especiales de todos modos (no puede anidarlas en C).”h]”(hŒšGente hereje de todo el mundo ha afirmado que esta inconsistencia es... bueno... inconsistente, pero todas las personas sensatas saben que (a) K&R tienen ”…””}”(hjh²hh³Nh´Nubj£)”}”(hŒ **razón**”h]”hŒrazón”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¢hjubhŒi y (b) K&R tienen razón. Además, las funciones son especiales de todos modos (no puede anidarlas en C).”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kªhj˜h²hubh¼)”}”(hŒúTenga en cuenta que la llave de cierre está vacía en su línea propia, **excepto** en los casos en que es seguida por una continuación de la misma declaración, es decir, un ``while`` en una sentencia do o un ``else`` en una sentencia if, como en:”h]”(hŒITenga en cuenta que la llave de cierre está vacía en su línea propia, ”…””}”(hj h²hh³Nh´Nubj£)”}”(hŒ **excepto**”h]”hŒexcepto”…””}”(hj(h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¢hj ubhŒ] en los casos en que es seguida por una continuación de la misma declaración, es decir, un ”…””}”(hj h²hh³Nh´Nubj*)”}”(hŒ ``while``”h]”hŒwhile”…””}”(hj:h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj ubhŒ en una sentencia do o un ”…””}”(hj h²hh³Nh´Nubj*)”}”(hŒ``else``”h]”hŒelse”…””}”(hjLh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj ubhŒ en una sentencia if, como en:”…””}”(hj h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K¯hj˜h²hubjŒ)”}”(hŒ5do { cuerpo del bucle do } while (condition);”h]”hŒ5do { cuerpo del bucle do } while (condition);”…””}”hjdsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´K´hj˜h²hubh¼)”}”(hŒy”h]”hŒy”…””}”(hjsh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kºhj˜h²hubjŒ)”}”(hŒPif (x == y) { .. } else if (x > y) { ... } else { .... }”h]”hŒPif (x == y) { .. } else if (x > y) { ... } else { .... }”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´K¼hj˜h²hubh¼)”}”(hŒJustificación: K&R.”h]”hŒJustificación: K&R.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KÆhj˜h²hubh¼)”}”(hXPAdemás, tenga en cuenta que esta colocación de llaves también minimiza el número de líneas vacías (o casi vacías), sin pérdida de legibilidad. Así, como el suministro de nuevas líneas en su pantalla no es un recurso renovable (piense en pantallas de terminal de 25 líneas), tienes más líneas vacías para poner comentarios.”h]”hXPAdemás, tenga en cuenta que esta colocación de llaves también minimiza el número de líneas vacías (o casi vacías), sin pérdida de legibilidad. Así, como el suministro de nuevas líneas en su pantalla no es un recurso renovable (piense en pantallas de terminal de 25 líneas), tienes más líneas vacías para poner comentarios.”…””}”(hjžh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KÈhj˜h²hubh¼)”}”(hŒJNo use llaves innecesariamente donde una sola declaración sea suficiente.”h]”hŒJNo use llaves innecesariamente donde una sola declaración sea suficiente.”…””}”(hj¬h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KÎhj˜h²hubjŒ)”}”(hŒ if (condition) accion();”h]”hŒ if (condition) accion();”…””}”hjºsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´KÐhj˜h²hubh¼)”}”(hjuh]”hŒy”…””}”(hjÉh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KÕhj˜h²hubjŒ)”}”(hŒ;if (condición) haz_esto(); else haz_eso();”h]”hŒ;if (condición) haz_esto(); else haz_eso();”…””}”hjÖsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžŒnone”j }”uh1j‹h³hìh´K×hj˜h²hubh¼)”}”(hŒEsto no aplica si solo una rama de una declaración condicional es una sola declaración; en este último caso utilice llaves en ambas ramas:”h]”hŒEsto no aplica si solo una rama de una declaración condicional es una sola declaración; en este último caso utilice llaves en ambas ramas:”…””}”(hjæh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KÞhj˜h²hubjŒ)”}”(hŒ[if (condición) { haz_esto(); haz_eso(); } else { en_otro_caso(); }”h]”hŒ[if (condición) { haz_esto(); haz_eso(); } else { en_otro_caso(); }”…””}”hjôsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´Káhj˜h²hubh¼)”}”(hŒMAdemás, use llaves cuando un bucle contenga más de una declaración simple:”h]”hŒMAdemás, use llaves cuando un bucle contenga más de una declaración simple:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kêhj˜h²hubjŒ)”}”(hŒCwhile (condición) { if (test) haz_eso(); }”h]”hŒCwhile (condición) { if (test) haz_eso(); }”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´Kìhj˜h²hubj†)”}”(hhh]”(j‹)”}”(hŒ 3.1) Espacios”h]”hŒ 3.1) Espacios”…””}”(hj#h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj h²hh³hìh´Kôubh¼)”}”(hXÔEl estilo del kernel Linux para el uso de espacios depende (principalmente) del uso de función versus uso de palabra clave. Utilice un espacio después de (la mayoría de) las palabras clave. Las excepciones notables son sizeof, typeof, alignof y __attribute__, que parecen algo así como funciones (y generalmente se usan con paréntesis en Linux, aunque no son requeridos en el idioma, como en: ``sizeof info`` después de que ``struct fileinfo info;`` se declare).”h]”(hXŽEl estilo del kernel Linux para el uso de espacios depende (principalmente) del uso de función versus uso de palabra clave. Utilice un espacio después de (la mayoría de) las palabras clave. Las excepciones notables son sizeof, typeof, alignof y __attribute__, que parecen algo así como funciones (y generalmente se usan con paréntesis en Linux, aunque no son requeridos en el idioma, como en: ”…””}”(hj1h²hh³Nh´Nubj*)”}”(hŒ``sizeof info``”h]”hŒ sizeof info”…””}”(hj9h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj1ubhŒ después de que ”…””}”(hj1h²hh³Nh´Nubj*)”}”(hŒ``struct fileinfo info;``”h]”hŒstruct fileinfo info;”…””}”(hjKh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj1ubhŒ se declare).”…””}”(hj1h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Köhj h²hubh¼)”}”(hŒ:Así que use un espacio después de estas palabras clave::”h]”hŒ9Así que use un espacio después de estas palabras clave:”…””}”(hjch²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kþhj h²hubjŒ)”}”(hŒ if, switch, case, for, do, while”h]”hŒ if, switch, case, for, do, while”…””}”hjqsbah}”(h]”h ]”h"]”h$]”h&]”j›jœuh1j‹h³hìh´Mhj h²hubh¼)”}”(hŒBpero no con sizeof, typeof, alignof, o __attribute__. Por ejemplo,”h]”hŒBpero no con sizeof, typeof, alignof, o __attribute__. Por ejemplo,”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhj h²hubjŒ)”}”(hŒs = sizeof(struct file);”h]”hŒs = sizeof(struct file);”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´Mhj h²hubh¼)”}”(hŒbNo agregue espacios alrededor (dentro) de expresiones entre paréntesis. Este ejemplo es **malo**:”h]”(hŒYNo agregue espacios alrededor (dentro) de expresiones entre paréntesis. Este ejemplo es ”…””}”(hjœh²hh³Nh´Nubj£)”}”(hŒ**malo**”h]”hŒmalo”…””}”(hj¤h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¢hjœubhŒ:”…””}”(hjœh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M hj h²hubjŒ)”}”(hŒs = sizeof( struct file );”h]”hŒs = sizeof( struct file );”…””}”hj¼sbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´M hj h²hubh¼)”}”(hŒÇAl declarar datos de puntero o una función que devuelve un tipo de puntero, el uso preferido de ``*`` es adyacente al nombre del dato o nombre de la función y no junto al nombre del tipo. Ejemplos:”h]”(hŒaAl declarar datos de puntero o una función que devuelve un tipo de puntero, el uso preferido de ”…””}”(hjËh²hh³Nh´Nubj*)”}”(hŒ``*``”h]”hŒ*”…””}”(hjÓh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjËubhŒa es adyacente al nombre del dato o nombre de la función y no junto al nombre del tipo. Ejemplos:”…””}”(hjËh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhj h²hubjŒ)”}”(hŒnchar *linux_banner; unsigned long long memparse(char *ptr, char **retptr); char *match_strdup(substring_t *s);”h]”hŒnchar *linux_banner; unsigned long long memparse(char *ptr, char **retptr); char *match_strdup(substring_t *s);”…””}”hjësbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´Mhj h²hubh¼)”}”(hŒxUse un espacio alrededor (a cada lado de) la mayoría de los operadores binarios y ternarios, como cualquiera de estos::”h]”hŒwUse un espacio alrededor (a cada lado de) la mayoría de los operadores binarios y ternarios, como cualquiera de estos:”…””}”(hjúh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhj h²hubjŒ)”}”(hŒ5= + - < > * / % | & ^ <= >= == != ? :”h]”hŒ5= + - < > * / % | & ^ <= >= == != ? :”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”j›jœuh1j‹h³hìh´Mhj h²hubh¼)”}”(hŒ5pero sin espacio después de los operadores unarios::”h]”hŒ4pero sin espacio después de los operadores unarios:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M!hj h²hubjŒ)”}”(hŒA& * + - ~ ! sizeof typeof alignof __attribute__ defined”h]”hŒA& * + - ~ ! sizeof typeof alignof __attribute__ defined”…””}”hj$sbah}”(h]”h ]”h"]”h$]”h&]”j›jœuh1j‹h³hìh´M#hj h²hubh¼)”}”(hŒSsin espacio antes de los operadores unarios de incremento y decremento del sufijo::”h]”hŒRsin espacio antes de los operadores unarios de incremento y decremento del sufijo:”…””}”(hj2h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M%hj h²hubjŒ)”}”(hŒ++ --”h]”hŒ++ --”…””}”hj@sbah}”(h]”h ]”h"]”h$]”h&]”j›jœuh1j‹h³hìh´M(hj h²hubh¼)”}”(hŒSy sin espacio alrededor de los operadores de miembros de estructura ``.`` y ``->``.”h]”(hŒDy sin espacio alrededor de los operadores de miembros de estructura ”…””}”(hjNh²hh³Nh´Nubj*)”}”(hŒ``.``”h]”hŒ.”…””}”(hjVh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjNubhŒ y ”…””}”(hjNh²hh³Nh´Nubj*)”}”(hŒ``->``”h]”hŒ->”…””}”(hjhh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjNubhŒ.”…””}”(hjNh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M*hj h²hubh¼)”}”(hXNo deje espacios en blanco al final de las líneas. Algunos editores con ``inteligente`` sangría insertarán espacios en blanco al comienzo de las nuevas líneas como sea apropiado, para que pueda comenzar a escribir la siguiente línea de código de inmediato. Sin embargo, algunos de estos editores no eliminan los espacios en blanco si finalmente no termina poniendo una línea de código allí, como si dejara una línea en blanco. Como resultado, termina con líneas que contienen espacios en blanco al final.”h]”(hŒINo deje espacios en blanco al final de las líneas. Algunos editores con ”…””}”(hj€h²hh³Nh´Nubj*)”}”(hŒ``inteligente``”h]”hŒ inteligente”…””}”(hjˆh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj€ubhX« sangría insertarán espacios en blanco al comienzo de las nuevas líneas como sea apropiado, para que pueda comenzar a escribir la siguiente línea de código de inmediato. Sin embargo, algunos de estos editores no eliminan los espacios en blanco si finalmente no termina poniendo una línea de código allí, como si dejara una línea en blanco. Como resultado, termina con líneas que contienen espacios en blanco al final.”…””}”(hj€h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M-hj h²hubh¼)”}”(hX-Git le advertirá sobre los parches que introducen espacios en blanco al final y puede, opcionalmente, eliminar los espacios en blanco finales por usted; sin embargo, si se aplica una serie de parches, esto puede hacer que los parches posteriores de la serie fallen al cambiar sus líneas de contexto.”h]”hX-Git le advertirá sobre los parches que introducen espacios en blanco al final y puede, opcionalmente, eliminar los espacios en blanco finales por usted; sin embargo, si se aplica una serie de parches, esto puede hacer que los parches posteriores de la serie fallen al cambiar sus líneas de contexto.”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M5hj h²hubeh}”(h]”Œespacios”ah ]”h"]”Œ 3.1) espacios”ah$]”h&]”uh1j…hj˜h²hh³hìh´Kôubeh}”(h]”Œcolocacion-de-llaves-y-espacios”ah ]”h"]”Œ#3) colocación de llaves y espacios”ah$]”h&]”uh1j…hj‡h²hh³hìh´Kubj†)”}”(hhh]”(j‹)”}”(hŒ4) Nomenclatura”h]”hŒ4) Nomenclatura”…””}”(hjÁh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj¾h²hh³hìh´M=ubh¼)”}”(hXeC es un lenguaje espartano, y sus convenciones de nomenclatura deberían seguir su ejemplo. A diferencia de los programadores de Modula-2 y Pascal, los programadores de C no usan nombres cuquis como EstaVariableEsUnContadorTemporal. Un programador de C lo llamaría variable ``tmp``, que es mucho más fácil de escribir, y no es mas difícil de comprender.”h]”(hXC es un lenguaje espartano, y sus convenciones de nomenclatura deberían seguir su ejemplo. A diferencia de los programadores de Modula-2 y Pascal, los programadores de C no usan nombres cuquis como EstaVariableEsUnContadorTemporal. Un programador de C lo llamaría variable ”…””}”(hjÏh²hh³Nh´Nubj*)”}”(hŒ``tmp``”h]”hŒtmp”…””}”(hj×h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjÏubhŒK, que es mucho más fácil de escribir, y no es mas difícil de comprender.”…””}”(hjÏh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M?hj¾h²hubh¼)”}”(hŒÒSIN EMBARGO, mientras que los nombres de mayúsculas y minúsculas están mal vistos, los nombres descriptivos para las variables globales son imprescindibles. Llamar a una función global ``foo`` es un delito.”h]”(hŒ½SIN EMBARGO, mientras que los nombres de mayúsculas y minúsculas están mal vistos, los nombres descriptivos para las variables globales son imprescindibles. Llamar a una función global ”…””}”(hjïh²hh³Nh´Nubj*)”}”(hŒ``foo``”h]”hŒfoo”…””}”(hj÷h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjïubhŒ es un delito.”…””}”(hjïh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MFhj¾h²hubh¼)”}”(hX-Una variable GLOBAL (para usar solo si **realmente** las necesita) necesita tener un nombre descriptivo, al igual que las funciones globales. Si tiene una función que cuenta el número de usuarios activos, debe llamar a esta ``contar_usuarios_activos()`` o similar, **no** debe llamarlo ``cntusr()``.”h]”(hŒ'Una variable GLOBAL (para usar solo si ”…””}”(hjh²hh³Nh´Nubj£)”}”(hŒ **realmente**”h]”hŒ realmente”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¢hjubhŒ® las necesita) necesita tener un nombre descriptivo, al igual que las funciones globales. Si tiene una función que cuenta el número de usuarios activos, debe llamar a esta ”…””}”(hjh²hh³Nh´Nubj*)”}”(hŒ``contar_usuarios_activos()``”h]”hŒcontar_usuarios_activos()”…””}”(hj)h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjubhŒ o similar, ”…””}”(hjh²hh³Nh´Nubj£)”}”(hŒ**no**”h]”hŒno”…””}”(hj;h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¢hjubhŒ debe llamarlo ”…””}”(hjh²hh³Nh´Nubj*)”}”(hŒ ``cntusr()``”h]”hŒcntusr()”…””}”(hjMh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjubhŒ.”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MJhj¾h²hubh¼)”}”(hŒÃCodificar el tipo de una función en el nombre (lo llamado notación húngara) es estúpido: el compilador conoce los tipos de todos modos y puede verificar estos, y solo confunde al programador.”h]”hŒÃCodificar el tipo de una función en el nombre (lo llamado notación húngara) es estúpido: el compilador conoce los tipos de todos modos y puede verificar estos, y solo confunde al programador.”…””}”(hjeh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MOhj¾h²hubh¼)”}”(hXnLos nombres de las variables LOCALES deben ser breves y directos. Si usted tiene algún contador aleatorio de tipo entero, probablemente debería llamarse ``i``. Llamarlo ``loop_counter`` no es productivo, si no hay posibilidad de ser mal entendido. De manera similar, ``tmp`` puede ser casi cualquier tipo de variable que se utiliza para contener un valor temporal.”h]”(hŒ›Los nombres de las variables LOCALES deben ser breves y directos. Si usted tiene algún contador aleatorio de tipo entero, probablemente debería llamarse ”…””}”(hjsh²hh³Nh´Nubj*)”}”(hŒ``i``”h]”hŒi”…””}”(hj{h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjsubhŒ . Llamarlo ”…””}”(hjsh²hh³Nh´Nubj*)”}”(hŒ``loop_counter``”h]”hŒ loop_counter”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjsubhŒR no es productivo, si no hay posibilidad de ser mal entendido. De manera similar, ”…””}”(hjsh²hh³Nh´Nubj*)”}”(hŒ``tmp``”h]”hŒtmp”…””}”(hjŸh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjsubhŒZ puede ser casi cualquier tipo de variable que se utiliza para contener un valor temporal.”…””}”(hjsh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MShj¾h²hubh¼)”}”(hŒÀSi tiene miedo de mezclar los nombres de las variables locales, tiene otro problema, que se denomina síndrome de función-crecimiento-desequilibrio-de-hormona. Vea el capítulo 6 (Funciones).”h]”hŒÀSi tiene miedo de mezclar los nombres de las variables locales, tiene otro problema, que se denomina síndrome de función-crecimiento-desequilibrio-de-hormona. Vea el capítulo 6 (Funciones).”…””}”(hj·h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MYhj¾h²hubh¼)”}”(hŒÒPara nombres de símbolos y documentación, evite introducir nuevos usos de 'master / slave' (maestro / esclavo) (o 'slave' independientemente de 'master') y 'lista negra / lista blanca' (backlist / whitelist).”h]”hŒâPara nombres de símbolos y documentación, evite introducir nuevos usos de ‘master / slave’ (maestro / esclavo) (o ‘slave’ independientemente de ‘master’) y ‘lista negra / lista blanca’ (backlist / whitelist).”…””}”(hjÅh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M]hj¾h²hubhŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒñLos reemplazos recomendados para 'maestro / esclavo' son: '{primary,main} / {secondary,replica,subordinate}' '{initiator,requester} / {target,responder}' '{controller,host} / {device,worker,proxy}' 'leader / follower' 'director / performer' ”h]”(hŒterm”“”)”}”(hŒ9Los reemplazos recomendados para 'maestro / esclavo' son:”h]”hŒ=Los reemplazos recomendados para ‘maestro / esclavo’ son:”…””}”(hjàh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÞh³hìh´MfhjÚubhŒ definition”“”)”}”(hhh]”h¼)”}”(hŒ¶'{primary,main} / {secondary,replica,subordinate}' '{initiator,requester} / {target,responder}' '{controller,host} / {device,worker,proxy}' 'leader / follower' 'director / performer'”h]”hŒÊ‘{primary,main} / {secondary,replica,subordinate}’ ‘{initiator,requester} / {target,responder}’ ‘{controller,host} / {device,worker,proxy}’ ‘leader / follower’ ‘director / performer’”…””}”(hjóh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mbhjðubah}”(h]”h ]”h"]”h$]”h&]”uh1jîhjÚubeh}”(h]”h ]”h"]”h$]”h&]”uh1jØh³hìh´MfhjÕubjÙ)”}”(hŒkLos reemplazos recomendados para 'backlist / whitelist' son: 'denylist / allowlist' 'blocklist / passlist' ”h]”(jß)”}”(hŒ`_. Por ejemplo, usando este ejemplo de declaración de función::”h]”(hŒ1Al escribir prototipos de funciones, mantenga el ”…””}”(hjD h²hh³Nh´NubjJ)”}”(hŒŠ`orden de los elementos regular `_”h]”hŒorden de los elementos regular”…””}”(hjL h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œorden de los elementos regular”Œrefuri”Œfhttps://lore.kernel.org/mm-commits/CAHk-=wiOCLRny5aifWNhr621kYrJwhfURsa0vFPeUEm8mF0ufg@mail.gmail.com/”uh1jIhjD ubjx)”}”(hŒi ”h]”h}”(h]”Œorden-de-los-elementos-regular”ah ]”h"]”Œorden de los elementos regular”ah$]”h&]”Œrefuri”j] uh1jwŒ referenced”KhjD ubhŒ?. Por ejemplo, usando este ejemplo de declaración de función:”…””}”(hjD h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mùhj h²hubjŒ)”}”(hŒ•__init void * __must_check action(enum magic value, size_t size, u8 count, char *fmt, ...) __printf(4, 5) __malloc;”h]”hŒ•__init void * __must_check action(enum magic value, size_t size, u8 count, char *fmt, ...) __printf(4, 5) __malloc;”…””}”hjv sbah}”(h]”h ]”h"]”h$]”h&]”j›jœuh1j‹h³hìh´Mýhj h²hubh¼)”}”(hŒAEl orden preferido de elementos para un prototipo de función es:”h]”hŒAEl orden preferido de elementos para un prototipo de función es:”…””}”(hj„ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhj h²hubhŒ bullet_list”“”)”}”(hhh]”(j )”}”(hŒ¬clase de almacenamiento (a continuación, ``static __always_inline``, teniendo en cuenta que ``__always_inline`` es técnicamente un atributo pero se trata como ``inline``)”h]”h¼)”}”(hŒ¬clase de almacenamiento (a continuación, ``static __always_inline``, teniendo en cuenta que ``__always_inline`` es técnicamente un atributo pero se trata como ``inline``)”h]”(hŒ*clase de almacenamiento (a continuación, ”…””}”(hj› h²hh³Nh´Nubj*)”}”(hŒ``static __always_inline``”h]”hŒstatic __always_inline”…””}”(hj£ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj› ubhŒ, teniendo en cuenta que ”…””}”(hj› h²hh³Nh´Nubj*)”}”(hŒ``__always_inline``”h]”hŒ__always_inline”…””}”(hjµ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj› ubhŒ1 es técnicamente un atributo pero se trata como ”…””}”(hj› h²hh³Nh´Nubj*)”}”(hŒ ``inline``”h]”hŒinline”…””}”(hjÇ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj› ubhŒ)”…””}”(hj› h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhj— ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj” h²hh³hìh´Nubj )”}”(hŒ„atributos de clase de almacenamiento (aquí, ``__init`` -- es decir, declaraciones de sección, pero también cosas como ``__cold``)”h]”h¼)”}”(hŒ„atributos de clase de almacenamiento (aquí, ``__init`` -- es decir, declaraciones de sección, pero también cosas como ``__cold``)”h]”(hŒ-atributos de clase de almacenamiento (aquí, ”…””}”(hjé h²hh³Nh´Nubj*)”}”(hŒ ``__init``”h]”hŒ__init”…””}”(hjñ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”u•Ùh1j)hjé ubhŒB -- es decir, declaraciones de sección, pero también cosas como ”…””}”(hjé h²hh³Nh´Nubj*)”}”(hŒ ``__cold``”h]”hŒ__cold”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjé ubhŒ)”…””}”(hjé h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhjå ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj” h²hh³hìh´Nubj )”}”(hŒ#tipo de retorno (aquí, ``void *``)”h]”h¼)”}”(hj# h]”(hŒtipo de retorno (aquí, ”…””}”(hj% h²hh³Nh´Nubj*)”}”(hŒ ``void *``”h]”hŒvoid *”…””}”(hj, h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj% ubhŒ)”…””}”(hj% h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhj! ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj” h²hh³hìh´Nubj )”}”(hŒ6atributos de tipo de retorno (aquí, ``__must_check``)”h]”h¼)”}”(hjL h]”(hŒ%atributos de tipo de retorno (aquí, ”…””}”(hjN h²hh³Nh´Nubj*)”}”(hŒ``__must_check``”h]”hŒ __must_check”…””}”(hjU h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjN ubhŒ)”…””}”(hjN h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MhjJ ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj” h²hh³hìh´Nubj )”}”(hŒ)nombre de la función (aquí, ``action``)”h]”h¼)”}”(hju h]”(hŒnombre de la función (aquí, ”…””}”(hjw h²hh³Nh´Nubj*)”}”(hŒ ``action``”h]”hŒaction”…””}”(hj~ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjw ubhŒ)”…””}”(hjw h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M hjs ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj” h²hh³hìh´Nubj )”}”(hŒ°parámetros de la función (aquí, ``(enum magic value, size_t size, u8 count, char *fmt, ...)``, teniendo en cuenta que los nombres de los parámetros siempre deben incluirse)”h]”h¼)”}”(hŒ°parámetros de la función (aquí, ``(enum magic value, size_t size, u8 count, char *fmt, ...)``, teniendo en cuenta que los nombres de los parámetros siempre deben incluirse)”h]”(hŒ#parámetros de la función (aquí, ”…””}”(hj  h²hh³Nh´Nubj*)”}”(hŒ=``(enum magic value, size_t size, u8 count, char *fmt, ...)``”h]”hŒ9(enum magic value, size_t size, u8 count, char *fmt, ...)”…””}”(hj¨ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj  ubhŒP, teniendo en cuenta que los nombres de los parámetros siempre deben incluirse)”…””}”(hj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M hjœ ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj” h²hh³hìh´Nubj )”}”(hŒ@atributos de parámetros de función (aquí, ``__printf(4, 5)``)”h]”h¼)”}”(hjÈ h]”(hŒ-atributos de parámetros de función (aquí, ”…””}”(hjÊ h²hh³Nh´Nubj*)”}”(hŒ``__printf(4, 5)``”h]”hŒ__printf(4, 5)”…””}”(hjÑ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjÊ ubhŒ)”…””}”(hjÊ h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M hjÆ ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj” h²hh³hìh´Nubj )”}”(hŒAatributos de comportamiento de la función (aquí, ``__malloc``) ”h]”h¼)”}”(hŒ@atributos de comportamiento de la función (aquí, ``__malloc``)”h]”(hŒ3atributos de comportamiento de la función (aquí, ”…””}”(hjó h²hh³Nh´Nubj*)”}”(hŒ ``__malloc``”h]”hŒ__malloc”…””}”(hjû h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjó ubhŒ)”…””}”(hjó h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhjï ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj” h²hh³hìh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1j’ h³hìh´Mhj h²hubh¼)”}”(hXœTenga en cuenta que para una **definición** de función (es decir, el cuerpo real de la función), el compilador no permite atributos de parámetros de función después de parámetros de la función. En estos casos, deberán ir tras los atributos de clase (por ejemplo, tenga en cuenta el cambio de posición de ``__printf(4, 5)`` a continuación, en comparación con el ejemplo de **declaración** anterior)::”h]”(hŒTenga en cuenta que para una ”…””}”(hj!h²hh³Nh´Nubj£)”}”(hŒ**definición**”h]”hŒ definición”…””}”(hj)h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¢hj!ubhX de función (es decir, el cuerpo real de la función), el compilador no permite atributos de parámetros de función después de parámetros de la función. En estos casos, deberán ir tras los atributos de clase (por ejemplo, tenga en cuenta el cambio de posición de ”…””}”(hj!h²hh³Nh´Nubj*)”}”(hŒ``__printf(4, 5)``”h]”hŒ__printf(4, 5)”…””}”(hj;h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj!ubhŒ4 a continuación, en comparación con el ejemplo de ”…””}”(hj!h²hh³Nh´Nubj£)”}”(hŒ**declaración**”h]”hŒ declaración”…””}”(hjMh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¢hj!ubhŒ anterior):”…””}”(hj!h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhj h²hubjŒ)”}”(hŒ§static __always_inline __init __printf(4, 5) void * __must_check action(enum magic value, size_t size, u8 count, char *fmt, ...) __malloc { ... }”h]”hŒ§static __always_inline __init __printf(4, 5) void * __must_check action(enum magic value, size_t size, u8 count, char *fmt, ...) __malloc { ... }”…””}”hjesbah}”(h]”h ]”h"]”h$]”h&]”j›jœuh1j‹h³hìh´Mhj h²hubeh}”(h]”Œprototipos-de-funciones”ah ]”h"]”Œ6.1) prototipos de funciones”ah$]”h&]”uh1j…hj h²hh³hìh´Mïubeh}”(h]”Œ funciones”ah ]”h"]”Œ 6) funciones”ah$]”h&]”uh1j…hj‡h²hh³hìh´MÈubj†)”}”(hhh]”(j‹)”}”(hŒ#7) Salida centralizada de funciones”h]”hŒ#7) Salida centralizada de funciones”…””}”(hj†h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjƒh²hh³hìh´Mubh¼)”}”(hŒ²Aunque desaprobado por algunas personas, el equivalente de la instrucción goto es utilizado con frecuencia por los compiladores, en forma de instrucción de salto incondicional.”h]”hŒ²Aunque desaprobado por algunas personas, el equivalente de la instrucción goto es utilizado con frecuencia por los compiladores, en forma de instrucción de salto incondicional.”…””}”(hj”h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M hjƒh²hubh¼)”}”(hŒÞLa declaración goto es útil cuando una función sale desde múltiples ubicaciones y se deben realizar algunos trabajos comunes, como la limpieza. Si no se necesita limpieza, entonces simplemente haga return directamente.”h]”hŒÞLa declaración goto es útil cuando una función sale desde múltiples ubicaciones y se deben realizar algunos trabajos comunes, como la limpieza. Si no se necesita limpieza, entonces simplemente haga return directamente.”…””}”(hj¢h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M$hjƒh²hubh¼)”}”(hX£Elija nombres de etiquetas que digan qué hace el goto o por qué existe el goto. Un ejemplo de un buen nombre podría ser ``out_free_buffer:`` (``salida_liberar_buffer``) si al irse libera ``buffer``. Evite usar nombres GW-BASIC como ``err1:`` y ``err2:``, ya que tendría que volver a numerarlos si alguna vez agrega o elimina rutas de salida, y hacen que sea difícil de verificar que sean correctos, de todos modos.”h]”(hŒ{Elija nombres de etiquetas que digan qué hace el goto o por qué existe el goto. Un ejemplo de un buen nombre podría ser ”…””}”(hj°h²hh³Nh´Nubj*)”}”(hŒ``out_free_buffer:``”h]”hŒout_free_buffer:”…””}”(hj¸h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj°ubhŒ (”…””}”(hj°h²hh³Nh´Nubj*)”}”(hŒ``salida_liberar_buffer``”h]”hŒsalida_liberar_buffer”…””}”(hjÊh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj°ubhŒ) si al irse libera ”…””}”(hj°h²hh³Nh´Nubj*)”}”(hŒ ``buffer``”h]”hŒbuffer”…””}”(hjÜh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj°ubhŒ#. Evite usar nombres GW-BASIC como ”…””}”(hj°h²hh³Nh´Nubj*)”}”(hŒ ``err1:``”h]”hŒerr1:”…””}”(hjîh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj°ubhŒ y ”…””}”(hj°h²hh³Nh´Nubj*)”}”(hŒ ``err2:``”h]”hŒerr2:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj°ubhŒ£, ya que tendría que volver a numerarlos si alguna vez agrega o elimina rutas de salida, y hacen que sea difícil de verificar que sean correctos, de todos modos.”…””}”(hj°h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M(hjƒh²hubh¼)”}”(hŒLa razón para usar gotos es:”h]”hŒLa razón para usar gotos es:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M/hjƒh²hubj“ )”}”(hhh]”(j )”}”(hŒILas declaraciones incondicionales son más fáciles de entender y seguir.”h]”h¼)”}”(hj+h]”hŒILas declaraciones incondicionales son más fáciles de entender y seguir.”…””}”(hj-h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M1hj)ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj&h²hh³hìh´Nubj )”}”(hŒse reduce el anidamiento”h]”h¼)”}”(hjBh]”hŒse reduce el anidamiento”…””}”(hjDh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M2hj@ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj&h²hh³hìh´Nubj )”}”(hŒ_errores al no actualizar los puntos de salida individuales al hacer modificaciones son evitados”h]”h¼)”}”(hŒ_errores al no actualizar los puntos de salida individuales al hacer modificaciones son evitados”h]”hŒ_errores al no actualizar los puntos de salida individuales al hacer modificaciones son evitados”…””}”(hj[h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M3hjWubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj&h²hh³hìh´Nubj )”}”(hŒDahorra el trabajo del compilador de optimizar código redundante ;) ”h]”h¼)”}”(hŒCahorra el trabajo del compilador de optimizar código redundante ;)”h]”hŒCahorra el trabajo del compilador de optimizar código redundante ;)”…””}”(hjsh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M5hjoubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj&h²hh³hìh´Nubeh}”(h]”h ]”h"]”h$]”h&]”jj uh1j’ h³hìh´M1hjƒh²hubjŒ)”}”(hX¢int fun(int a) { int result = 0; char *buffer; buffer = kmalloc(SIZE, GFP_KERNEL); if (!buffer) return -ENOMEM; if (condition1) { while (loop1) { ... } result = 1; goto out_free_buffer; } ... out_free_buffer: kfree(buffer); return result; }”h]”hX¢int fun(int a) { int result = 0; char *buffer; buffer = kmalloc(SIZE, GFP_KERNEL); if (!buffer) return -ENOMEM; if (condition1) { while (loop1) { ... } result = 1; goto out_free_buffer; } ... out_free_buffer: kfree(buffer); return result; }”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´M7hjƒh²hubh¼)”}”(hŒRUn tipo común de error a tener en cuenta es "un error de error" que es algo así:”h]”hŒVUn tipo común de error a tener en cuenta es “un error de error†que es algo así:”…””}”(hjœh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MOhjƒh²hubjŒ)”}”(hŒEerr: kfree(foo->bar); kfree(foo); return ret;”h]”hŒEerr: kfree(foo->bar); kfree(foo); return ret;”…””}”hjªsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´MRhjƒh²hubh¼)”}”(hŒ½El error en este código es que en algunas rutas de salida, ``foo`` es NULL. Normalmente la solución para esto es dividirlo en dos etiquetas de error ``err_free_bar:`` y ``err_free_foo:``:”h]”(hŒbar); err_free_foo: kfree(foo); return ret;”h]”hŒ\err_free_bar: kfree(foo->bar); err_free_foo: kfree(foo); return ret;”…””}”hjýsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´M]hjƒh²hubh¼)”}”(hŒKIdealmente, debería simular errores para probar todas las rutas de salida.”h]”hŒKIdealmente, debería simular errores para probar todas las rutas de salida.”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mehjƒh²hubeh}”(h]”Œ salida-centralizada-de-funciones”ah ]”h"]”Œ#7) salida centralizada de funciones”ah$]”h&]”uh1j…hj‡h²hh³hìh´Mubj†)”}”(hhh]”(j‹)”}”(hŒ8) Comentarios”h]”hŒ8) Comentarios”…””}”(hj%h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj"h²hh³hìh´Miubh¼)”}”(hXLos comentarios son buenos, pero también existe el peligro de comentar demasiado. NUNCA trate de explicar CÓMO funciona su código en un comentario: es mucho mejor escribir el código para que el **funcionamiento** sea obvio y es una pérdida de tiempo explicar código mal escrito.”h]”(hŒÆLos comentarios son buenos, pero también existe el peligro de comentar demasiado. NUNCA trate de explicar CÓMO funciona su código en un comentario: es mucho mejor escribir el código para que el ”…””}”(hj3h²hh³Nh´Nubj£)”}”(hŒ**funcionamiento**”h]”hŒfuncionamiento”…””}”(hj;h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¢hj3ubhŒD sea obvio y es una pérdida de tiempo explicar código mal escrito.”…””}”(hj3h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mkhj"h²hubh¼)”}”(hX0Generalmente, desea que sus comentarios digan QUÉ hace su código, no CÓMO. Además, trate de evitar poner comentarios dentro del cuerpo de una función: si la función es tan compleja que necesita comentar por separado partes de esta, probablemente debería volver al capítulo 6 una temporada. Puede hacer pequeños comentarios para notar o advertir sobre algo particularmente inteligente (o feo), pero trate de evitar el exceso. En su lugar, ponga los comentarios al principio de la función, diga a la gente lo que hace y posiblemente POR QUÉ hace esto.”h]”hX0Generalmente, desea que sus comentarios digan QUÉ hace su código, no CÓMO. Además, trate de evitar poner comentarios dentro del cuerpo de una función: si la función es tan compleja que necesita comentar por separado partes de esta, probablemente debería volver al capítulo 6 una temporada. Puede hacer pequeños comentarios para notar o advertir sobre algo particularmente inteligente (o feo), pero trate de evitar el exceso. En su lugar, ponga los comentarios al principio de la función, diga a la gente lo que hace y posiblemente POR QUÉ hace esto.”…””}”(hjSh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mqhj"h²hubh¼)”}”(hŒÃAl comentar las funciones de la API del kernel, utilice el formato kernel-doc. Consulte los archivos en :ref:`Documentation/doc-guide/ ` y ``tools/docs/kernel-doc`` para más detalles.”h]”(hŒhAl comentar las funciones de la API del kernel, utilice el formato kernel-doc. Consulte los archivos en ”…””}”(hjah²hh³Nh´Nubh)”}”(hŒ+:ref:`Documentation/doc-guide/ `”h]”hú)”}”(hjkh]”hŒDocumentation/doc-guide/”…””}”(hjmh²hh³Nh´Nubah}”(h]”h ]”(jŒstd”Œstd-ref”eh"]”h$]”h&]”uh1hùhjiubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jŒ refdomain”jwŒreftype”Œref”Œ refexplicit”ˆŒrefwarn”ˆjŒ doc_guide”uh1hh³hìh´MzhjaubhŒ y ”…””}”(hjah²hh³Nh´Nubj*)”}”(hŒ``tools/docs/kernel-doc``”h]”hŒtools/docs/kernel-doc”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjaubhŒ para más detalles.”…””}”(hjah²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mzhj"h²hubh¼)”}”(hŒCEl estilo preferido para comentarios largos (de varias líneas) es:”h]”hŒCEl estilo preferido para comentarios largos (de varias líneas) es:”…””}”(hj¥h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M~hj"h²hubjŒ)”}”(hX/* * Este es el estilo preferido para comentarios * multilínea en el código fuente del kernel Linux. * Por favor, utilícelo constantemente. * * Descripción: Una columna de asteriscos en el lado izquierdo, * con líneas iniciales y finales casi en blanco. */”h]”hX/* * Este es el estilo preferido para comentarios * multilínea en el código fuente del kernel Linux. * Por favor, utilícelo constantemente. * * Descripción: Una columna de asteriscos en el lado izquierdo, * con líneas iniciales y finales casi en blanco. */”…””}”hj³sbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´M€hj"h²hubh¼)”}”(hŒuPara archivos en net/ y drivers/net/, el estilo preferido para comentarios largos (multi-linea) es un poco diferente.”h]”hŒuPara archivos en net/ y drivers/net/, el estilo preferido para comentarios largos (multi-linea) es un poco diferente.”…””}”(hjÂh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M‹hj"h²hubjŒ)”}”(hŒÚ/* El estilo de comentario preferido para archivos en net/ y drivers/net * se asemeja a esto. * * Es casi lo mismo que el estilo de comentario generalmente preferido, * pero no hay una línea inicial casi en blanco. */”h]”hŒÚ/* El estilo de comentario preferido para archivos en net/ y drivers/net * se asemeja a esto. * * Es casi lo mismo que el estilo de comentario generalmente preferido, * pero no hay una línea inicial casi en blanco. */”…””}”hjÐsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´MŽhj"h²hubh¼)”}”(hXTambién es importante comentar los datos, ya sean tipos básicos o derivados. Para este fin, use solo una declaración de datos por línea (sin comas para múltiples declaraciones de datos). Esto le deja espacio para un pequeño comentario sobre cada elemento, explicando su uso.”h]”hXTambién es importante comentar los datos, ya sean tipos básicos o derivados. Para este fin, use solo una declaración de datos por línea (sin comas para múltiples declaraciones de datos). Esto le deja espacio para un pequeño comentario sobre cada elemento, explicando su uso.”…””}”(hjßh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M—hj"h²hubeh}”(h]”Œ comentarios”ah ]”h"]”Œ8) comentarios”ah$]”h&]”uh1j…hj‡h²hh³hìh´Miubj†)”}”(hhh]”(j‹)”}”(hŒ9) Has hecho un desastre”h]”hŒ9) Has hecho un desastre”…””}”(hjøh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjõh²hh³hìh´Mubh¼)”}”(hX|Está bien, todos lo hacemos. Probablemente un antiguo usuario de Unix le haya dicho que ``GNU emacs`` formatea automáticamente las fuentes C por usted, y ha notado que sí, lo hace, pero los por defecto que tiene son menos que deseables (de hecho, son peores que los aleatorios) escribiendo - un número infinito de monos escribiendo en GNU emacs nunca harán un buen programa).”h]”(hŒYEstá bien, todos lo hacemos. Probablemente un antiguo usuario de Unix le haya dicho que ”…””}”(hjh²hh³Nh´Nubj*)”}”(hŒ ``GNU emacs``”h]”hŒ GNU emacs”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjubhX formatea automáticamente las fuentes C por usted, y ha notado que sí, lo hace, pero los por defecto que tiene son menos que deseables (de hecho, son peores que los aleatorios) escribiendo - un número infinito de monos escribiendo en GNU emacs nunca harán un buen programa).”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MŸhjõh²hubh¼)”}”(hŒšPor lo tanto, puede deshacerse de GNU emacs o cambiarlo y usar valores más sanos. Para hacer esto último, puede pegar lo siguiente en su archivo .emacs:”h]”hŒšPor lo tanto, puede deshacerse de GNU emacs o cambiarlo y usar valores más sanos. Para hacer esto último, puede pegar lo siguiente en su archivo .emacs:”…””}”(hj&h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M¦hjõh²hubjŒ)”}”(hX(defun c-lineup-arglist-tabs-only (ignored) "Line up argument lists by tabs, not spaces" (let* ((anchor (c-langelem-pos c-syntactic-element)) (column (c-langelem-2nd-pos c-syntactic-element)) (offset (- (1+ column) anchor)) (steps (floor offset c-basic-offset))) (* (max steps 1) c-basic-offset))) (dir-locals-set-class-variables 'linux-kernel '((c-mode . ( (c-basic-offset . 8) (c-label-minimum-indentation . 0) (c-offsets-alist . ( (arglist-close . c-lineup-arglist-tabs-only) (arglist-cont-nonempty . (c-lineup-gcc-asm-reg c-lineup-arglist-tabs-only)) (arglist-intro . +) (brace-list-intro . +) (c . c-lineup-C-comments) (case-label . 0) (comment-intro . c-lineup-comment) (cpp-define-intro . +) (cpp-macro . -1000) (cpp-macro-cont . +) (defun-block-intro . +) (else-clause . 0) (func-decl-cont . +) (inclass . +) (inher-cont . c-lineup-multi-inher) (knr-argdecl-intro . 0) (label . -1000) (statement . 0) (statement-block-intro . +) (statement-case-intro . +) (statement-cont . +) (substatement . +) )) (indent-tabs-mode . t) (show-trailing-whitespace . t) )))) (dir-locals-set-directory-class (expand-file-name "~/src/linux-trees") 'linux-kernel)”h]”hX(defun c-lineup-arglist-tabs-only (ignored) "Line up argument lists by tabs, not spaces" (let* ((anchor (c-langelem-pos c-syntactic-element)) (column (c-langelem-2nd-pos c-syntactic-element)) (offset (- (1+ column) anchor)) (steps (floor offset c-basic-offset))) (* (max steps 1) c-basic-offset))) (dir-locals-set-class-variables 'linux-kernel '((c-mode . ( (c-basic-offset . 8) (c-label-minimum-indentation . 0) (c-offsets-alist . ( (arglist-close . c-lineup-arglist-tabs-only) (arglist-cont-nonempty . (c-lineup-gcc-asm-reg c-lineup-arglist-tabs-only)) (arglist-intro . +) (brace-list-intro . +) (c . c-lineup-C-comments) (case-label . 0) (comment-intro . c-lineup-comment) (cpp-define-intro . +) (cpp-macro . -1000) (cpp-macro-cont . +) (defun-block-intro . +) (else-clause . 0) (func-decl-cont . +) (inclass . +) (inher-cont . c-lineup-multi-inher) (knr-argdecl-intro . 0) (label . -1000) (statement . 0) (statement-block-intro . +) (statement-case-intro . +) (statement-cont . +) (substatement . +) )) (indent-tabs-mode . t) (show-trailing-whitespace . t) )))) (dir-locals-set-directory-class (expand-file-name "~/src/linux-trees") 'linux-kernel)”…””}”hj4sbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžŒnone”j }”uh1j‹h³hìh´Mªhjõh²hubh¼)”}”(hŒvEsto hará que emacs funcione mejor con el estilo de código del kernel para C en archivos bajo ``~/src/linux-trees``.”h]”(hŒ`Esto hará que emacs funcione mejor con el estilo de código del kernel para C en archivos bajo ”…””}”(hjDh²hh³Nh´Nubj*)”}”(hŒ``~/src/linux-trees``”h]”hŒ~/src/linux-trees”…””}”(hjLh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjDubhŒ.”…””}”(hjDh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MÛhjõh²hubh¼)”}”(hŒgPero incluso si no logra que emacs realice un formateo correcto, no todo está perdido: use ``indent``.”h]”(hŒ\Pero incluso si no logra que emacs realice un formateo correcto, no todo está perdido: use ”…””}”(hjdh²hh³Nh´Nubj*)”}”(hŒ ``indent``”h]”hŒindent”…””}”(hjlh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjdubhŒ.”…””}”(hjdh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MÞhjõh²hubh¼)”}”(hXAhora bien, de nuevo, la sangría de GNU tiene la misma configuración de muerte cerebral que GNU emacs tiene, por lo que necesita darle algunas opciones de línea de comando. Sin embargo, eso no es tan malo, porque incluso los creadores de GNU indent reconocen la autoridad de K&R (la gente de GNU no es mala, solo están gravemente equivocados en este asunto), por lo que simplemente de a la sangría las opciones ``-kr -i8`` (significa ``K&R, guiones de 8 caracteres``), o use ``scripts/Lindent``, que indenta con ese estilo.”h]”(hX Ahora bien, de nuevo, la sangría de GNU tiene la misma configuración de muerte cerebral que GNU emacs tiene, por lo que necesita darle algunas opciones de línea de comando. Sin embargo, eso no es tan malo, porque incluso los creadores de GNU indent reconocen la autoridad de K&R (la gente de GNU no es mala, solo están gravemente equivocados en este asunto), por lo que simplemente de a la sangría las opciones ”…””}”(hj„h²hh³Nh´Nubj*)”}”(hŒ ``-kr -i8``”h]”hŒ-kr -i8”…””}”(hjŒh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj„ubhŒ (significa ”…””}”(hj„h²hh³Nh´Nubj*)”}”(hŒ ``K&R, guiones de 8 caracteres``”h]”hŒK&R, guiones de 8 caracteres”…””}”(hjžh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj„ubhŒ ), o use ”…””}”(hj„h²hh³Nh´Nubj*)”}”(hŒ``scripts/Lindent``”h]”hŒscripts/Lindent”…””}”(hj°h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj„ubhŒ, que indenta con ese estilo.”…””}”(hj„h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Máhjõh²hubh¼)”}”(hŒã``indent`` tiene muchas opciones, y especialmente cuando se trata de comentar reformateos, es posible que desee echar un vistazo a la página del manual. Pero recuerde: ``indent`` no es la solución para una mala programación.”h]”(j*)”}”(hŒ ``indent``”h]”hŒindent”…””}”(hjÌh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjÈubhŒŸ tiene muchas opciones, y especialmente cuando se trata de comentar reformateos, es posible que desee echar un vistazo a la página del manual. Pero recuerde: ”…””}”(hjÈh²hh³Nh´Nubj*)”}”(hŒ ``indent``”h]”hŒindent”…””}”(hjÞh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjÈubhŒ0 no es la solución para una mala programación.”…””}”(hjÈh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mêhjõh²hubh¼)”}”(hXTenga en cuenta que también puede usar la herramienta ``clang-format`` para ayudarlo con estas reglas, para volver a formatear rápidamente partes de su código automáticamente, y revisar archivos completos para detectar errores de estilo del código, errores tipográficos y posibles mejoras. También es útil para ordenar ``#includes``, para alinear variables/macros, para redistribuir texto y otras tareas similares. Vea el archivo :ref:`Documentation/dev-tools/clang-format.rst ` para más detalles.”h]”(hŒ7Tenga en cuenta que también puede usar la herramienta ”…””}”(hjöh²hh³Nh´Nubj*)”}”(hŒ``clang-format``”h]”hŒ clang-format”…””}”(hjþh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjöubhX para ayudarlo con estas reglas, para volver a formatear rápidamente partes de su código automáticamente, y revisar archivos completos para detectar errores de estilo del código, errores tipográficos y posibles mejoras. También es útil para ordenar ”…””}”(hjöh²hh³Nh´Nubj*)”}”(hŒ ``#includes``”h]”hŒ #includes”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjöubhŒb, para alinear variables/macros, para redistribuir texto y otras tareas similares. Vea el archivo ”…””}”(hjöh²hh³Nh´Nubh)”}”(hŒ=:ref:`Documentation/dev-tools/clang-format.rst `”h]”hú)”}”(hj$h]”hŒ(Documentation/dev-tools/clang-format.rst”…””}”(hj&h²hh³Nh´Nubah}”(h]”h ]”(jŒstd”Œstd-ref”eh"]”h$]”h&]”uh1hùhj"ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jŒ refdomain”j0Œreftype”Œref”Œ refexplicit”ˆŒrefwarn”ˆjŒ clangformat”uh1hh³hìh´MïhjöubhŒ para más detalles.”…””}”(hjöh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mïhjõh²hubeh}”(h]”Œhas-hecho-un-desastre”ah ]”h"]”Œ9) has hecho un desastre”ah$]”h&]”uh1j…hj‡h²hh³hìh´Mubj†)”}”(hhh]”(j‹)”}”(hŒ)10) Archivos de configuración de Kconfig”h]”hŒ)10) Archivos de configuración de Kconfig”…””}”(hjWh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjTh²hh³hìh´Mùubh¼)”}”(hXPara todos los archivos de configuración de Kconfig* en todo el árbol fuente, la sangría es algo diferente. Las líneas bajo una definición ``config`` están indentadas con una tabulación, mientras que el texto de ayuda tiene una sangría adicional de dos espacios. Ejemplo::”h]”(hŒPara todos los archivos de configuración de Kconfig* en todo el árbol fuente, la sangría es algo diferente. Las líneas bajo una definición ”…””}”(hjeh²hh³Nh´Nubj*)”}”(hŒ ``config``”h]”hŒconfig”…””}”(hjmh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjeubhŒ} están indentadas con una tabulación, mientras que el texto de ayuda tiene una sangría adicional de dos espacios. Ejemplo:”…””}”(hjeh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MûhjTh²hubjŒ)”}”(hXMconfig AUDIT bool "Soporte para auditar" depends on NET help Habilita la infraestructura de auditoría que se puede usar con otro subsistema kernel, como SELinux (que requiere esto para registro de salida de mensajes avc). No hace auditoría de llamadas al sistema sin CONFIG_AUDITSYSCALL.”h]”hXMconfig AUDIT bool "Soporte para auditar" depends on NET help Habilita la infraestructura de auditoría que se puede usar con otro subsistema kernel, como SELinux (que requiere esto para registro de salida de mensajes avc). No hace auditoría de llamadas al sistema sin CONFIG_AUDITSYSCALL.”…””}”hj…sbah}”(h]”h ]”h"]”h$]”h&]”j›jœuh1j‹h³hìh´MhjTh²hubh¼)”}”(hŒžCaracterísticas seriamente peligrosas (como soporte de escritura para ciertos filesystems) deben anunciar esto de forma destacada en su cadena de solicitud::”h]”hŒCaracterísticas seriamente peligrosas (como soporte de escritura para ciertos filesystems) deben anunciar esto de forma destacada en su cadena de solicitud:”…””}”(hj“h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M hjTh²hubjŒ)”}”(hŒ`config ADFS_FS_RW bool "ADFS write support (DANGEROUS)" depends on ADFS_FS ...”h]”hŒ`config ADFS_FS_RW bool "ADFS write support (DANGEROUS)" depends on ADFS_FS ...”…””}”hj¡sbah}”(h]”h ]”h"]”h$]”h&]”j›jœuh1j‹h³hìh´M hjTh²hubh¼)”}”(hŒŒPara obtener la documentación completa sobre los archivos de configuración, consulte el archivo Documentation/kbuild/kconfig-language.rst.”h]”hŒŒPara obtener la documentación completa sobre los archivos de configuración, consulte el archivo Documentation/kbuild/kconfig-language.rst.”…””}”(hj¯h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MhjTh²hubeh}”(h]”Œ$archivos-de-configuracion-de-kconfig”ah ]”h"]”Œ)10) archivos de configuración de kconfig”ah$]”h&]”uh1j…hj‡h²hh³hìh´Mùubj†)”}”(hhh]”(j‹)”}”(hŒ11) Estructuras de datos”h]”hŒ11) Estructuras de datos”…””}”(hjÈh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjÅh²hh³hìh´Mubh¼)”}”(hXLas estructuras de datos que tienen visibilidad fuera del contexto de un solo subproceso en el que son creadas y destruidas, siempre debe tener contadores de referencia. En el kernel, la recolección de basura no existe (y fuera, la recolección de basura del kernel es lenta e ineficiente), lo que significa que absolutamente **tiene** para hacer referencia y contar todos sus usos.”h]”(hXGLas estructuras de datos que tienen visibilidad fuera del contexto de un solo subproceso en el que son creadas y destruidas, siempre debe tener contadores de referencia. En el kernel, la recolección de basura no existe (y fuera, la recolección de basura del kernel es lenta e ineficiente), lo que significa que absolutamente ”…””}”(hjÖh²hh³Nh´Nubj£)”}”(hŒ **tiene**”h]”hŒtiene”…””}”(hjÞh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¢hjÖubhŒ/ para hacer referencia y contar todos sus usos.”…””}”(hjÖh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MhjÅh²hubh¼)”}”(hX/El conteo de referencias significa que puede evitar el bloqueo y permite que múltiples usuarios tengan acceso a la estructura de datos en paralelo - y no tengan que preocuparse de que la estructura, de repente, desaparezca debajo de su control, solo porque durmieron o hicieron otra cosa por un tiempo.”h]”hX/El conteo de referencias significa que puede evitar el bloqueo y permite que múltiples usuarios tengan acceso a la estructura de datos en paralelo - y no tengan que preocuparse de que la estructura, de repente, desaparezca debajo de su control, solo porque durmieron o hicieron otra cosa por un tiempo.”…””}”(hjöh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M hjÅh²hubh¼)”}”(hX-Tenga en cuenta que el bloqueo **no** reemplaza el recuento de referencia. El bloqueo se utiliza para mantener la coherencia de las estructuras de datos, mientras que la referencia y contar es una técnica de gestión de memoria. Por lo general, ambos son necesarios, y no deben confundirse entre sí.”h]”(hŒTenga en cuenta que el bloqueo ”…””}”(hjh²hh³Nh´Nubj£)”}”(hŒ**no**”h]”hŒno”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¢hjubhX reemplaza el recuento de referencia. El bloqueo se utiliza para mantener la coherencia de las estructuras de datos, mientras que la referencia y contar es una técnica de gestión de memoria. Por lo general, ambos son necesarios, y no deben confundirse entre sí.”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M&hjÅh²hubh¼)”}”(hX#De hecho, muchas estructuras de datos pueden tener dos niveles de conteo de referencias, cuando hay usuarios de diferentes ``clases``. El conteo de subclases cuenta el número de usuarios de la subclase y disminuye el conteo global solo una vez, cuando el recuento de subclases llega a cero.”h]”(hŒ{De hecho, muchas estructuras de datos pueden tener dos niveles de conteo de referencias, cuando hay usuarios de diferentes ”…””}”(hj$h²hh³Nh´Nubj*)”}”(hŒ ``clases``”h]”hŒclases”…””}”(hj,h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj$ubhŒž. El conteo de subclases cuenta el número de usuarios de la subclase y disminuye el conteo global solo una vez, cuando el recuento de subclases llega a cero.”…””}”(hj$h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M,hjÅh²hubh¼)”}”(hŒøSe pueden encontrar ejemplos de este tipo de ``recuento de referencias de niveles múltiples`` en la gestión de memoria (``struct mm_struct``: mm_users y mm_count), y en código del sistema de archivos (``struct super_block``: s_count y s_active).”h]”(hŒ-Se pueden encontrar ejemplos de este tipo de ”…””}”(hjDh²hh³Nh´Nubj*)”}”(hŒ1``recuento de referencias de niveles múltiples``”h]”hŒ-recuento de referencias de niveles múltiples”…””}”(hjLh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjDubhŒ en la gestión de memoria (”…””}”(hjDh²hh³Nh´Nubj*)”}”(hŒ``struct mm_struct``”h]”hŒstruct mm_struct”…””}”(hj^h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjDubhŒ>: mm_users y mm_count), y en código del sistema de archivos (”…””}”(hjDh²hh³Nh´Nubj*)”}”(hŒ``struct super_block``”h]”hŒstruct super_block”…””}”(hjph²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjDubhŒ: s_count y s_active).”…””}”(hjDh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M1hjÅh²hubh¼)”}”(hŒRecuerde: si otro hilo puede encontrar su estructura de datos y usted no tiene un recuento de referencias, es casi seguro que tiene un error.”h]”hŒRecuerde: si otro hilo puede encontrar su estructura de datos y usted no tiene un recuento de referencias, es casi seguro que tiene un error.”…””}”(hjˆh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M6hjÅh²hubeh}”(h]”Œestructuras-de-datos”ah ]”h"]”Œ11) estructuras de datos”ah$]”h&]”uh1j…hj‡h²hh³hìh´Mubj†)”}”(hhh]”(j‹)”}”(hŒ12) Macros, Enums y RTL”h]”hŒ12) Macros, Enums y RTL”…””}”(hj¡h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjžh²hh³hìh´M:ubh¼)”}”(hŒhLos nombres de macros que definen constantes y etiquetas en enumeraciones (enums) están en mayúsculas.”h]”hŒhLos nombres de macros que definen constantes y etiquetas en enumeraciones (enums) están en mayúsculas.”…””}”(hj¯h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M<hjžh²hubjŒ)”}”(hŒ#define CONSTANTE 0x12345”h]”hŒ#define CONSTANTE 0x12345”…””}”hj½sbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´M?hjžh²hubh¼)”}”(hŒHSe prefieren los enums cuando se definen varias constantes relacionadas.”h]”hŒHSe prefieren los enums cuando se definen varias constantes relacionadas.”…””}”(hjÌh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MChjžh²hubh¼)”}”(hŒSe aprecian los nombres de macro en MAYÚSCULAS, pero las macros que se asemejan a funciones puede ser nombradas en minúscula.”h]”hŒSe aprecian los nombres de macro en MAYÚSCULAS, pero las macros que se asemejan a funciones puede ser nombradas en minúscula.”…””}”(hjÚh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MEhjžh²hubh¼)”}”(hŒ_Generalmente, las funciones en línea son preferibles a las macros que se asemejan a funciones.”h]”hŒ_Generalmente, las funciones en línea son preferibles a las macros que se asemejan a funciones.”…””}”(hjèh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MHhjžh²hubh¼)”}”(hŒKLas macros con varias instrucciones deben contenerse en un bloque do-while:”h]”hŒKLas macros con varias instrucciones deben contenerse en un bloque do-while:”…””}”(hjöh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MKhjžh²hubjŒ)”}”(hŒÛ#define macrofun(a, b, c) \ do { \ if (a == 5) \ haz_esto(b, c); \ } while (0)”h]”hŒÛ#define macrofun(a, b, c) \ do { \ if (a == 5) \ haz_esto(b, c); \ } while (0)”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´MMhjžh²hubh¼)”}”(hŒCosas a evitar al usar macros:”h]”hŒCosas a evitar al usar macros:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MUhjžh²hubj )”}”(hhh]”j )”}”(hŒ(macros que afectan el flujo de control: ”h]”h¼)”}”(hŒ'macros que afectan el flujo de control:”h]”hŒ'macros que afectan el flujo de control:”…””}”(hj(h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MWhj$ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj!h²hh³hìh´Nubah}”(h]”h ]”h"]”h$]”h&]”jK Œarabic”jM hjO jP uh1j hjžh²hh³hìh´MWubjŒ)”}”(hŒÛ#define FOO(x) \ do { \ if (blah(x) < 0) \ return -EBUGGERED; \ } while (0)”h]”hŒÛ#define FOO(x) \ do { \ if (blah(x) < 0) \ return -EBUGGERED; \ } while (0)”…””}”hjCsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´MYhjžh²hubh¼)”}”(hŒ¨es una **muy** mala idea. Parece una llamada de función pero sale de la función de ``llamada``; no rompa los analizadores internos de aquellos que leerán el código.”h]”(hŒes una ”…””}”(hjRh²hh³Nh´Nubj£)”}”(hŒ**muy**”h]”hŒmuy”…””}”(hjZh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¢hjRubhŒG mala idea. Parece una llamada de función pero sale de la función de ”…””}”(hjRh²hh³Nh´Nubj*)”}”(hŒ ``llamada``”h]”hŒllamada”…””}”(hjlh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjRubhŒH; no rompa los analizadores internos de aquellos que leerán el código.”…””}”(hjRh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mahjžh²hubj )”}”(hhh]”j )”}”(hŒGmacros que dependen de tener una variable local con un nombre mágico: ”h]”h¼)”}”(hŒFmacros que dependen de tener una variable local con un nombre mágico:”h]”hŒFmacros que dependen de tener una variable local con un nombre mágico:”…””}”(hj‹h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mehj‡ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj„h²hh³hìh´Nubah}”(h]”h ]”h"]”h$]”h&]”jK jBjM hjO jP Œstart”Kuh1j hjžh²hh³hìh´MeubjŒ)”}”(hŒ #define FOO(val) bar(index, val)”h]”hŒ #define FOO(val) bar(index, val)”…””}”hj¦sbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´Mghjžh²hubh¼)”}”(hŒ“puede parecer algo bueno, pero es confuso como el infierno cuando uno lee el código, y es propenso a romperse por cambios aparentemente inocentes.”h]”hŒ“puede parecer algo bueno, pero es confuso como el infierno cuando uno lee el código, y es propenso a romperse por cambios aparentemente inocentes.”…””}”(hjµh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mkhjžh²hubh¼)”}”(hŒ’3) macros con argumentos que se usan como valores l: FOO(x) = y; le van a morder si alguien, por ejemplo, convierte FOO en una función en línea.”h]”hŒ’3) macros con argumentos que se usan como valores l: FOO(x) = y; le van a morder si alguien, por ejemplo, convierte FOO en una función en línea.”…””}”(hjÃh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mnhjžh²hubh¼)”}”(hŒÉ4) olvidarse de la precedencia: las macros que definen constantes usando expresiones deben encerrar la expresión entre paréntesis. Tenga cuidado con problemas similares con macros usando parámetros.”h]”hŒÉ4) olvidarse de la precedencia: las macros que definen constantes usando expresiones deben encerrar la expresión entre paréntesis. Tenga cuidado con problemas similares con macros usando parámetros.”…””}”(hjÑh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mqhjžh²hubjŒ)”}”(hŒ9#define CONSTANTE 0x4000 #define CONSTEXP (CONSTANTE | 3)”h]”hŒ9#define CONSTANTE 0x4000 #define CONSTEXP (CONSTANTE | 3)”…””}”hjßsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´Muhjžh²hubh¼)”}”(hŒu5) colisiones de espacio de nombres ("namespace") al definir variables locales en macros que se asemejan a funciones:”h]”hŒy5) colisiones de espacio de nombres (“namespaceâ€) al definir variables locales en macros que se asemejan a funciones:”…””}”(hjîh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mzhjžh²hubjŒ)”}”(hŒÔ#define FOO(x) \ ({ \ typeof(x) ret; \ ret = calc_ret(x); \ (ret); \ })”h]”hŒÔ#define FOO(x) \ ({ \ typeof(x) ret; \ ret = calc_ret(x); \ (ret); \ })”…””}”hjüsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´M}hjžh²hubh¼)”}”(hŒret es un nombre común para una variable local -es menos probable que __foo_ret colisione (coincida) con una variable existente.”h]”hŒret es un nombre común para una variable local -es menos probable que __foo_ret colisione (coincida) con una variable existente.”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M†hjžh²hubh¼)”}”(hŒ¤El manual de cpp trata las macros de forma exhaustiva. El manual interno de gcc también cubre RTL, que se usa frecuentemente con lenguaje ensamblador en el kernel.”h]”hŒ¤El manual de cpp trata las macros de forma exhaustiva. El manual interno de gcc también cubre RTL, que se usa frecuentemente con lenguaje ensamblador en el kernel.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M‰hjžh²hubeh}”(h]”Œmacros-enums-y-rtl”ah ]”h"]”Œ12) macros, enums y rtl”ah$]”h&]”uh1j…hj‡h²hh³hìh´M:ubj†)”}”(hhh]”(j‹)”}”(hŒ 13) Imprimir mensajes del kernel”h]”hŒ 13) Imprimir mensajes del kernel”…””}”(hj2h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj/h²hh³hìh´MŽubh¼)”}”(hX*A los desarrolladores del kernel les gusta ser vistos como alfabetizados. Cuide la ortografía de los mensajes del kernel para causar una buena impresión. No utilice contracciones incorrectas como ``dont``; use ``do not`` o ``don't`` en su lugar. Haga sus mensajes concisos, claros e inequívocos.”h]”(hŒÆA los desarrolladores del kernel les gusta ser vistos como alfabetizados. Cuide la ortografía de los mensajes del kernel para causar una buena impresión. No utilice contracciones incorrectas como ”…””}”(hj@h²hh³Nh´Nubj*)”}”(hŒ``dont``”h]”hŒdont”…””}”(hjHh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj@ubhŒ; use ”…””}”(hj@h²hh³Nh´Nubj*)”}”(hŒ ``do not``”h]”hŒdo not”…””}”(hjZh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj@ubhŒ o ”…””}”(hj@h²hh³Nh´Nubj*)”}”(hŒ ``don't``”h]”hŒdon't”…””}”(hjlh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj@ubhŒ@ en su lugar. Haga sus mensajes concisos, claros e inequívocos.”…””}”(hj@h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhj/h²hubh¼)”}”(hŒ que debe usar para asegurarse de que los mensajes coincidan con el dispositivo correcto y driver, y están etiquetados con el nivel correcto: dev_err(), dev_warn(), dev_info(), y así sucesivamente. Para mensajes que no están asociados con un dispositivo particular, define pr_notice(), pr_info(), pr_warn(), pr_err(), etc.”h]”hX¤Hay varias modelos de macros de diagnóstico de driver en que debe usar para asegurarse de que los mensajes coincidan con el dispositivo correcto y driver, y están etiquetados con el nivel correcto: dev_err(), dev_warn(), dev_info(), y así sucesivamente. Para mensajes que no están asociados con un dispositivo particular, define pr_notice(), pr_info(), pr_warn(), pr_err(), etc.”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mšhj/h²hubh¼)”}”(hX„Crear buenos mensajes de depuración puede ser todo un desafío; y una vez los tiene, pueden ser de gran ayuda para la resolución remota de problemas. Sin embargo, la impresión de mensajes de depuración se maneja de manera diferente a la impresión de otros mensajes que no son de depuración. Mientras que las otras funciones pr_XXX() se imprimen incondicionalmente, pr_debug() no lo hace; se compila fuera por defecto, a menos que DEBUG sea definido o se establezca CONFIG_DYNAMIC_DEBUG. Eso es cierto para dev_dbg() también, y una convención relacionada usa VERBOSE_DEBUG para agregar mensajes dev_vdbg() a los ya habilitados por DEBUG.”h]”hX„Crear buenos mensajes de depuración puede ser todo un desafío; y una vez los tiene, pueden ser de gran ayuda para la resolución remota de problemas. Sin embargo, la impresión de mensajes de depuración se maneja de manera diferente a la impresión de otros mensajes que no son de depuración. Mientras que las otras funciones pr_XXX() se imprimen incondicionalmente, pr_debug() no lo hace; se compila fuera por defecto, a menos que DEBUG sea definido o se establezca CONFIG_DYNAMIC_DEBUG. Eso es cierto para dev_dbg() también, y una convención relacionada usa VERBOSE_DEBUG para agregar mensajes dev_vdbg() a los ya habilitados por DEBUG.”…””}”(hj®h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M¡hj/h²hubh¼)”}”(hXdMuchos subsistemas tienen opciones de depuración de Kconfig para activar -DDEBUG en el Makefile correspondiente; en otros casos, los archivos usan #define DEBUG. Y cuando un mensaje de depuración debe imprimirse incondicionalmente, por ejemplo si es ya dentro de una sección #ifdef relacionada con la depuración, printk(KERN_DEBUG ...) puede ser usado.”h]”hXdMuchos subsistemas tienen opciones de depuración de Kconfig para activar -DDEBUG en el Makefile correspondiente; en otros casos, los archivos usan #define DEBUG. Y cuando un mensaje de depuración debe imprimirse incondicionalmente, por ejemplo si es ya dentro de una sección #ifdef relacionada con la depuración, printk(KERN_DEBUG ...) puede ser usado.”…””}”(hj¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M«hj/h²hubeh}”(h]”Œimprimir-mensajes-del-kernel”ah ]”h"]”Œ 13) imprimir mensajes del kernel”ah$]”h&]”uh1j…hj‡h²hh³hìh´MŽubj†)”}”(hhh]”(j‹)”}”(hŒ14) Reservando memoria”h]”hŒ14) Reservando memoria”…””}”(hjÕh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjÒh²hh³hìh´M²ubh¼)”}”(hX:El kernel proporciona los siguientes asignadores de memoria de propósito general: kmalloc(), kzalloc(), kmalloc_array(), kcalloc(), vmalloc() y vzalloc(). Consulte la documentación de la API para obtener más información. a cerca de ellos. :ref:`Documentation/core-api/memory-allocation.rst `”h]”(hŒóEl kernel proporciona los siguientes asignadores de memoria de propósito general: kmalloc(), kzalloc(), kmalloc_array(), kcalloc(), vmalloc() y vzalloc(). Consulte la documentación de la API para obtener más información. a cerca de ellos. ”…””}”(hjãh²hh³Nh´Nubh)”}”(hŒG:ref:`Documentation/core-api/memory-allocation.rst `”h]”hú)”}”(hjíh]”hŒ,Documentation/core-api/memory-allocation.rst”…””}”(hjïh²hh³Nh´Nubah}”(h]”h ]”(jŒstd”Œstd-ref”eh"]”h$]”h&]”uh1hùhjëubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jŒ refdomain”jùŒreftype”Œref”Œ refexplicit”ˆŒrefwarn”ˆjŒmemory_allocation”uh1hh³hìh´M´hjãubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M´hjÒh²hubh¼)”}”(hŒKLa forma preferida para pasar el tamaño de una estructura es la siguiente:”h]”hŒKLa forma preferida para pasar el tamaño de una estructura es la siguiente:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MºhjÒh²hubjŒ)”}”(hŒp = kmalloc(sizeof(*p), ...);”h]”hŒp = kmalloc(sizeof(*p), ...);”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´M¼hjÒh²hubh¼)”}”(hXLa forma alternativa donde se deletrea el nombre de la estructura perjudica la legibilidad, y presenta una oportunidad para un error cuando se cambia el tipo de variable de puntero, pero el tamaño correspondiente de eso que se pasa a un asignador de memoria no.”h]”hXLa forma alternativa donde se deletrea el nombre de la estructura perjudica la legibilidad, y presenta una oportunidad para un error cuando se cambia el tipo de variable de puntero, pero el tamaño correspondiente de eso que se pasa a un asignador de memoria no.”…””}”(hj.h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MÀhjÒh²hubh¼)”}”(hŒÁConvertir el valor devuelto, que es un puntero vacío, es redundante. La conversión desde el puntero vacío a cualquier otro tipo de puntero está garantizado por la programación en idioma C.”h]”hŒÁConvertir el valor devuelto, que es un puntero vacío, es redundante. La conversión desde el puntero vacío a cualquier otro tipo de puntero está garantizado por la programación en idioma C.”…””}”(hj<h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MÅhjÒh²hubh¼)”}”(hŒ;La forma preferida para asignar una matriz es la siguiente:”h]”hŒ;La forma preferida para asignar una matriz es la siguiente:”…””}”(hjJh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MÉhjÒh²hubjŒ)”}”(hŒ'p = kmalloc_array(n, sizeof(...), ...);”h]”hŒ'p = kmalloc_array(n, sizeof(...), ...);”…””}”hjXsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´MËhjÒh²hubh¼)”}”(hŒBLa forma preferida para asignar una matriz a cero es la siguiente:”h]”hŒBLa forma preferida para asignar una matriz a cero es la siguiente:”…””}”(hjgh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MÏhjÒh²hubjŒ)”}”(hŒ!p = kcalloc(n, sizeof(...), ...);”h]”hŒ!p = kcalloc(n, sizeof(...), ...);”…””}”hjusbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´MÑhjÒh²hubh¼)”}”(hŒyAmbos casos verifican el desbordamiento en el tamaño de asignación n * sizeof (...), y devuelven NULL si esto ocurrió.”h]”hŒyAmbos casos verifican el desbordamiento en el tamaño de asignación n * sizeof (...), y devuelven NULL si esto ocurrió.”…””}”(hj„h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MÕhjÒh²hubh¼)”}”(hŒåTodas estas funciones de asignación genéricas emiten un volcado de pila (" stack dump") en caso de fallo cuando se usan sin __GFP_NOWARN, por lo que no sirve de nada emitir un mensaje de fallo adicional cuando se devuelva NULL.”h]”hŒéTodas estas funciones de asignación genéricas emiten un volcado de pila (†stack dumpâ€) en caso de fallo cuando se usan sin __GFP_NOWARN, por lo que no sirve de nada emitir un mensaje de fallo adicional cuando se devuelva NULL.”…””}”(hj’h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MØhjÒh²hubeh}”(h]”Œreservando-memoria”ah ]”h"]”Œ14) reservando memoria”ah$]”h&]”uh1j…hj‡h²hh³hìh´M²ubj†)”}”(hhh]”(j‹)”}”(hŒ15) La enfermedad de inline”h]”hŒ15) La enfermedad de inline”…””}”(hj«h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj¨h²hh³hìh´MÞubh¼)”}”(hXëParece haber una común percepción errónea de que gcc tiene una magica opción "hazme más rápido" de aceleración, llamada ``inline`` (en línea). Mientras que el uso de inlines puede ser apropiado (por ejemplo, como un medio para reemplazar macros, consulte el Capítulo 12), muy a menudo no lo es. El uso abundante de la palabra clave inline conduce a una mayor kernel, que a su vez ralentiza el sistema en su conjunto, debido a una mayor huella de icache para la CPU, y sencillamente porque hay menos memoria disponible para el pagecache. Solo piense en esto; un fallo en la memoria caché de la página provoca una búsqueda de disco, que tarda fácilmente 5 milisegundos. Hay MUCHOS ciclos de CPU que puede entrar en estos 5 milisegundos.”h]”(hŒƒParece haber una común percepción errónea de que gcc tiene una magica opción “hazme más rápido†de aceleración, llamada ”…””}”(hj¹h²hh³Nh´Nubj*)”}”(hŒ ``inline``”h]”hŒinline”…””}”(hjÁh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj¹ubhXb (en línea). Mientras que el uso de inlines puede ser apropiado (por ejemplo, como un medio para reemplazar macros, consulte el Capítulo 12), muy a menudo no lo es. El uso abundante de la palabra clave inline conduce a una mayor kernel, que a su vez ralentiza el sistema en su conjunto, debido a una mayor huella de icache para la CPU, y sencillamente porque hay menos memoria disponible para el pagecache. Solo piense en esto; un fallo en la memoria caché de la página provoca una búsqueda de disco, que tarda fácilmente 5 milisegundos. Hay MUCHOS ciclos de CPU que puede entrar en estos 5 milisegundos.”…””}”(hj¹h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Màhj¨h²hubh¼)”}”(hX´Una razonable regla general es no poner funciones inline que tengan más de 3 líneas de código en ellas. Una excepción a esta regla son los casos en que se sabe que un parámetro es una constante en tiempo de compilación, y como resultado de esto, usted *sabe*, el compilador podrá optimizar la mayor parte de su función en tiempo de compilación. Para un buen ejemplo de este último caso, véase la función en línea kmalloc().”h]”(hXUna razonable regla general es no poner funciones inline que tengan más de 3 líneas de código en ellas. Una excepción a esta regla son los casos en que se sabe que un parámetro es una constante en tiempo de compilación, y como resultado de esto, usted ”…””}”(hjÙh²hh³Nh´NubhŒemphasis”“”)”}”(hŒ*sabe*”h]”hŒsabe”…””}”(hjãh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jáhjÙubhŒ¬, el compilador podrá optimizar la mayor parte de su función en tiempo de compilación. Para un buen ejemplo de este último caso, véase la función en línea kmalloc().”…””}”(hjÙh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mëhj¨h²hubh¼)”}”(hXÁA menudo, la gente argumenta que agregar funciones en línea que son estáticas y se usan solo una vez, es siempre una victoria ya que no hay perdida de espacio. Mientras esto es técnicamente correcto, gcc es capaz de incorporarlos automáticamente sin ayuda, y esta el problema de mantenimiento de eliminar el inline, cuando un segundo usuario supera el valor potencial de la pista que le dice a gcc que haga algo que habría hecho de todos modos.”h]”hXÁA menudo, la gente argumenta que agregar funciones en línea que son estáticas y se usan solo una vez, es siempre una victoria ya que no hay perdida de espacio. Mientras esto es técnicamente correcto, gcc es capaz de incorporarlos automáticamente sin ayuda, y esta el problema de mantenimiento de eliminar el inline, cuando un segundo usuario supera el valor potencial de la pista que le dice a gcc que haga algo que habría hecho de todos modos.”…””}”(hjûh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mòhj¨h²hubeh}”(h]”Œla-enfermedad-de-inline”ah ]”h"]”Œ15) la enfermedad de inline”ah$]”h&]”uh1j…hj‡h²hh³hìh´MÞubj†)”}”(hhh]”(j‹)”}”(hŒ016) Valores devueltos por función y sus nombres”h]”hŒ016) Valores devueltos por función y sus nombres”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjh²hh³hìh´Mûubh¼)”}”(hXFLas funciones pueden devolver valores de muchos tipos diferentes, y uno de lo más común es un valor que indica si la función tuvo éxito o ha fallado. Dicho valor se puede representar como un número entero de código de error (-Exxx = falla, 0 = éxito) o un booleano ``con éxito`` (0 = falla, distinto de cero = éxito).”h]”(hXLas funciones pueden devolver valores de muchos tipos diferentes, y uno de lo más común es un valor que indica si la función tuvo éxito o ha fallado. Dicho valor se puede representar como un número entero de código de error (-Exxx = falla, 0 = éxito) o un booleano ”…””}”(hj"h²hh³Nh´Nubj*)”}”(hŒ``con éxito``”h]”hŒ con éxito”…””}”(hj*h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj"ubhŒ( (0 = falla, distinto de cero = éxito).”…””}”(hj"h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mýhjh²hubh¼)”}”(hXGLa mezcla de estos dos tipos de representaciones es una fuente fértil de errores difíciles de encontrar. Si el lenguaje C incluyera una fuerte distinción entre enteros y booleanos, el compilador encontraría estos errores por nosotros... pero no lo hace. Para ayudar a prevenir tales errores, siga siempre esta convención::”h]”hXFLa mezcla de estos dos tipos de representaciones es una fuente fértil de errores difíciles de encontrar. Si el lenguaje C incluyera una fuerte distinción entre enteros y booleanos, el compilador encontraría estos errores por nosotros... pero no lo hace. Para ayudar a prevenir tales errores, siga siempre esta convención:”…””}”(hjBh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhjh²hubjŒ)”}”(hŒÚSi el nombre de una función es una acción o un comando imperativo, la función debe devolver un número entero de código de error. si el nombre es un predicado, la función debe devolver un valor booleano "exitoso".”h]”hŒÚSi el nombre de una función es una acción o un comando imperativo, la función debe devolver un número entero de código de error. si el nombre es un predicado, la función debe devolver un valor booleano "exitoso".”…””}”hjPsbah}”(h]”h ]”h"]”h$]”h&]”j›jœuh1j‹h³hìh´M hjh²hubh¼)”}”(hXAPor ejemplo, ``agregar trabajo`` es un comando, y la función agregar_trabajo() devuelve 0 en caso de éxito o -EBUSY en caso de fracaso. De la misma manera, ``dispositivo PCI presente`` es un predicado, y la función pci_dev_present() devuelve 1 si tiene éxito en encontrar un dispositivo coincidente o 0 si no es así.”h]”(hŒ Por ejemplo, ”…””}”(hj^h²hh³Nh´Nubj*)”}”(hŒ``agregar trabajo``”h]”hŒagregar trabajo”…””}”(hjfh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj^ubhŒ~ es un comando, y la función agregar_trabajo() devuelve 0 en caso de éxito o -EBUSY en caso de fracaso. De la misma manera, ”…””}”(hj^h²hh³Nh´Nubj*)”}”(hŒ``dispositivo PCI presente``”h]”hŒdispositivo PCI presente”…””}”(hjxh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj^ubhŒ‡ es un predicado, y la función pci_dev_present() devuelve 1 si tiene éxito en encontrar un dispositivo coincidente o 0 si no es así.”…””}”(hj^h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M hjh²hubh¼)”}”(hŒÌTodas las funciones EXPORTed (exportadas) deben respetar esta convención, al igual que todas las funciones publicas. Las funciones privadas (estáticas) no lo necesitan, pero es recomendado que lo hagan.”h]”hŒÌTodas las funciones EXPORTed (exportadas) deben respetar esta convención, al igual que todas las funciones publicas. Las funciones privadas (estáticas) no lo necesitan, pero es recomendado que lo hagan.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhjh²hubh¼)”}”(hXoLas funciones cuyo valor devuelto es el resultado real de un cálculo, en lugar de una indicación de si el cómputo tuvo éxito, no están sujetas a esta regla. Generalmente indican fallo al devolver valores fuera del rango de resultados. Los ejemplos típicos serían funciones que devuelven punteros; estos usan NULL o el mecanismo ERR_PTR para informar de fallos.”h]”hXoLas funciones cuyo valor devuelto es el resultado real de un cálculo, en lugar de una indicación de si el cómputo tuvo éxito, no están sujetas a esta regla. Generalmente indican fallo al devolver valores fuera del rango de resultados. Los ejemplos típicos serían funciones que devuelven punteros; estos usan NULL o el mecanismo ERR_PTR para informar de fallos.”…””}”(hjžh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhjh²hubeh}”(h]”Œ+valores-devueltos-por-funcion-y-sus-nombres”ah ]”h"]”Œ016) valores devueltos por función y sus nombres”ah$]”h&]”uh1j…hj‡h²hh³hìh´Mûubj†)”}”(hhh]”(j‹)”}”(hŒ17) Usando bool”h]”hŒ17) Usando bool”…””}”(hj·h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj´h²hh³hìh´Mubh¼)”}”(hXHEl tipo bool del kernel Linux es un alias para el tipo C99 _Bool. Los valores booleanos pueden solo evaluar a 0 o 1, y la conversión implícita o explícita a bool convierte automáticamente el valor en verdadero o falso. Cuando se utilizan tipos booleanos, !! no se necesita construcción, lo que elimina una clase de errores.”h]”hXHEl tipo bool del kernel Linux es un alias para el tipo C99 _Bool. Los valores booleanos pueden solo evaluar a 0 o 1, y la conversión implícita o explícita a bool convierte automáticamente el valor en verdadero o falso. Cuando se utilizan tipos booleanos, !! no se necesita construcción, lo que elimina una clase de errores.”…””}”(hjÅh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M hj´h²hubh¼)”}”(hŒmCuando se trabaja con valores booleanos, se deben usar las definiciones verdadera y falsa, en lugar de 1 y 0.”h]”hŒmCuando se trabaja con valores booleanos, se deben usar las definiciones verdadera y falsa, en lugar de 1 y 0.”…””}”(hjÓh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M&hj´h²hubh¼)”}”(hŒùLos tipos de devolución de función bool y las variables de pila siempre se pueden usar cuando esto sea adecuado. Se recomienda el uso de bool para mejorar la legibilidad y, a menudo, es una mejor opción que 'int' para almacenar valores booleanos.”•¿}h]”hŒýLos tipos de devolución de función bool y las variables de pila siempre se pueden usar cuando esto sea adecuado. Se recomienda el uso de bool para mejorar la legibilidad y, a menudo, es una mejor opción que ‘int’ para almacenar valores booleanos.”…””}”(hjáh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M)hj´h²hubh¼)”}”(hŒüNo use bool si el diseño de la línea de caché o el tamaño del valor son importantes, ya que su tamaño y la alineación varía según la arquitectura compilada. Las estructuras que son optimizadas para la alineación y el tamaño no debe usar bool.”h]”hŒüNo use bool si el diseño de la línea de caché o el tamaño del valor son importantes, ya que su tamaño y la alineación varía según la arquitectura compilada. Las estructuras que son optimizadas para la alineación y el tamaño no debe usar bool.”…””}”(hjïh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M.hj´h²hubh¼)”}”(hŒ¨Si una estructura tiene muchos valores verdadero/falso, considere consolidarlos en un bitfield con miembros de 1 bit, o usando un tipo de ancho fijo apropiado, como u8.”h]”hŒ¨Si una estructura tiene muchos valores verdadero/falso, considere consolidarlos en un bitfield con miembros de 1 bit, o usando un tipo de ancho fijo apropiado, como u8.”…””}”(hjýh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M3hj´h²hubh¼)”}”(hX'De manera similar, para los argumentos de función, se pueden consolidar muchos valores verdaderos/falsos en un solo argumento bit a bit 'flags' y 'flags' a menudo, puede ser una alternativa de argumento más legible si los sitios de llamada tienen constantes desnudas de tipo verdaderas/falsas.”h]”hX/De manera similar, para los argumentos de función, se pueden consolidar muchos valores verdaderos/falsos en un solo argumento bit a bit ‘flags’ y ‘flags’ a menudo, puede ser una alternativa de argumento más legible si los sitios de llamada tienen constantes desnudas de tipo verdaderas/falsas.”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M7hj´h²hubh¼)”}”(hŒbDe lo contrario, el uso limitado de bool en estructuras y argumentos puede mejorar la legibilidad.”h]”hŒbDe lo contrario, el uso limitado de bool en estructuras y argumentos puede mejorar la legibilidad.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M<hj´h²hubeh}”(h]”Œ usando-bool”ah ]”h"]”Œ17) usando bool”ah$]”h&]”uh1j…hj‡h²hh³hìh´Mubj†)”}”(hhh]”(j‹)”}”(hŒ&18) No reinvente las macros del kernel”h]”hŒ&18) No reinvente las macros del kernel”…””}”(hj2h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj/h²hh³hìh´M@ubh¼)”}”(hŒùEl archivo de cabecera include/linux/kernel.h contiene una serie de macros que debe usar, en lugar de programar explícitamente alguna variante de estos por usted mismo. Por ejemplo, si necesita calcular la longitud de una matriz, aproveche la macro”h]”hŒùEl archivo de cabecera include/linux/kernel.h contiene una serie de macros que debe usar, en lugar de programar explícitamente alguna variante de estos por usted mismo. Por ejemplo, si necesita calcular la longitud de una matriz, aproveche la macro”…””}”(hj@h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MBhj/h²hubjŒ)”}”(hŒ2#define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))”h]”hŒ2#define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))”…””}”hjNsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´MGhj/h²hubh¼)”}”(hŒZDe manera similar, si necesita calcular el tamaño de algún miembro de la estructura, use”h]”hŒZDe manera similar, si necesita calcular el tamaño de algún miembro de la estructura, use”…””}”(hj]h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MKhj/h²hubjŒ)”}”(hŒ/#define sizeof_field(t, f) (sizeof(((t*)0)->f))”h]”hŒ/#define sizeof_field(t, f) (sizeof(((t*)0)->f))”…””}”hjksbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´MNhj/h²hubh¼)”}”(hŒïTambién hay macros min() y max() que realizan una verificación estricta de tipos si lo necesita. Siéntase libre de leer detenidamente ese archivo de encabezado para ver qué más ya está definido y que no debe reproducir en su código.”h]”hŒïTambién hay macros min() y max() que realizan una verificación estricta de tipos si lo necesita. Siéntase libre de leer detenidamente ese archivo de encabezado para ver qué más ya está definido y que no debe reproducir en su código.”…””}”(hjzh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MRhj/h²hubeh}”(h]”Œ"no-reinvente-las-macros-del-kernel”ah ]”h"]”Œ&18) no reinvente las macros del kernel”ah$]”h&]”uh1j…hj‡h²hh³hìh´M@ubj†)”}”(hhh]”(j‹)”}”(hŒ'19) Editores modeline y otros desastres”h]”hŒ'19) Editores modeline y otros desastres”…””}”(hj“h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjh²hh³hìh´MXubh¼)”}”(hŒÊAlgunos editores pueden interpretar la información de configuración incrustada en los archivos fuente, indicado con marcadores especiales. Por ejemplo, emacs interpreta las líneas marcadas como esto:”h]”hŒÊAlgunos editores pueden interpretar la información de configuración incrustada en los archivos fuente, indicado con marcadores especiales. Por ejemplo, emacs interpreta las líneas marcadas como esto:”…””}”(hj¡h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MZhjh²hubjŒ)”}”(hŒ-*- mode: c -*-”h]”hŒ-*- mode: c -*-”…””}”hj¯sbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´M^hjh²hubh¼)”}”(hŒO así:”h]”hŒO así:”…””}”(hj¾h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mbhjh²hubjŒ)”}”(hŒK/* Local Variables: compile-command: "gcc -DMAGIC_DEBUG_FLAG foo.c" End: */”h]”hŒK/* Local Variables: compile-command: "gcc -DMAGIC_DEBUG_FLAG foo.c" End: */”…””}”hjÌsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´Mdhjh²hubh¼)”}”(hŒ.Vim interpreta los marcadores que se ven así:”h]”hŒ.Vim interpreta los marcadores que se ven así:”…””}”(hjÛh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mlhjh²hubjŒ)”}”(hŒ/* vim:set sw=8 noet */”h]”hŒ/* vim:set sw=8 noet */”…””}”hjésbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´Mnhjh²hubh¼)”}”(hX`No incluya ninguno de estos en los archivos fuente. La gente tiene sus propias configuraciones del editor, y sus archivos de origen no deben anularlos. Esto incluye marcadores para sangría y configuración de modo. La gente puede usar su propio modo personalizado, o puede tener algún otro método mágico para que la sangría funcione correctamente.”h]”hX`No incluya ninguno de estos en los archivos fuente. La gente tiene sus propias configuraciones del editor, y sus archivos de origen no deben anularlos. Esto incluye marcadores para sangría y configuración de modo. La gente puede usar su propio modo personalizado, o puede tener algún otro método mágico para que la sangría funcione correctamente.”…””}”(hjøh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mrhjh²hubeh}”(h]”Œ#editores-modeline-y-otros-desastres”ah ]”h"]”Œ'19) editores modeline y otros desastres”ah$]”h&]”uh1j…hj‡h²hh³hìh´MXubj†)”}”(hhh]”(j‹)”}”(hŒ20) Ensamblador inline”h]”hŒ20) Ensamblador inline”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjh²hh³hìh´Mzubh¼)”}”(hXVEn el código específico de arquitectura, es posible que deba usar ensamblador en línea para interactuar con funcionalidades de CPU o plataforma. No dude en hacerlo cuando sea necesario. Sin embargo, no use ensamblador en línea de forma gratuita cuando C puede hacer el trabajo. Puede y debe empujar el hardware desde C cuando sea posible.”h]”hXVEn el código específico de arquitectura, es posible que deba usar ensamblador en línea para interactuar con funcionalidades de CPU o plataforma. No dude en hacerlo cuando sea necesario. Sin embargo, no use ensamblador en línea de forma gratuita cuando C puede hacer el trabajo. Puede y debe empujar el hardware desde C cuando sea posible.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M|hjh²hubh¼)”}”(hŒÙConsidere escribir funciones auxiliares simples que envuelvan bits comunes de ensamblador, en lugar de escribirlos repetidamente con ligeras variaciones. Recuerde que el ensamblador en línea puede usar parámetros C.”h]”hŒÙConsidere escribir funciones auxiliares simples que envuelvan bits comunes de ensamblador, en lugar de escribirlos repetidamente con ligeras variaciones. Recuerde que el ensamblador en línea puede usar parámetros C.”…””}”(hj-h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M‚hjh²hubh¼)”}”(hŒáLas funciones de ensamblador grandes y no triviales deben ir en archivos .S, con su correspondientes prototipos de C definidos en archivos de encabezado en C. Los prototipos de C para el ensamblador deben usar ``asmlinkage``.”h]”(hŒÒLas funciones de ensamblador grandes y no triviales deben ir en archivos .S, con su correspondientes prototipos de C definidos en archivos de encabezado en C. Los prototipos de C para el ensamblador deben usar ”…””}”(hj;h²hh³Nh´Nubj*)”}”(hŒ``asmlinkage``”h]”hŒ asmlinkage”…””}”(hjCh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hj;ubhŒ.”…””}”(hj;h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M†hjh²hubh¼)”}”(hŒïEs posible que deba marcar su declaración asm como volátil, para evitar que GCC la elimine si GCC no nota ningún efecto secundario. No siempre es necesario hacerlo, sin embargo, y hacerlo innecesariamente puede limitar la optimización.”h]”hŒïEs posible que deba marcar su declaración asm como volátil, para evitar que GCC la elimine si GCC no nota ningún efecto secundario. No siempre es necesario hacerlo, sin embargo, y hacerlo innecesariamente puede limitar la optimización.”…””}”(hj[h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MŠhjh²hubh¼)”}”(hX1Al escribir una sola declaración de ensamblador en línea que contiene múltiples instrucciones, ponga cada instrucción en una línea separada en una string separada, y termine cada string excepto la última con ``\n\t`` para indentar correctamente la siguiente instrucción en la salida en ensamblador:”h]”(hŒÖAl escribir una sola declaración de ensamblador en línea que contiene múltiples instrucciones, ponga cada instrucción en una línea separada en una string separada, y termine cada string excepto la última con ”…””}”(hjih²hh³Nh´Nubj*)”}”(hŒ``\n\t``”h]”hŒ\n\t”…””}”(hjqh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjiubhŒS para indentar correctamente la siguiente instrucción en la salida en ensamblador:”…””}”(hjih²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhjh²hubjŒ)”}”(hŒqasm ("magic %reg1, #42\n\t" "more_magic %reg2, %reg3" : /* outputs */ : /* inputs */ : /* clobbers */);”h]”hŒqasm ("magic %reg1, #42\n\t" "more_magic %reg2, %reg3" : /* outputs */ : /* inputs */ : /* clobbers */);”…””}”hj‰sbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´M•hjh²hubeh}”(h]”Œensamblador-inline”ah ]”h"]”Œ20) ensamblador inline”ah$]”h&]”uh1j…hj‡h²hh³hìh´Mzubj†)”}”(hhh]”(j‹)”}”(hŒ21) Compilación condicional”h]”hŒ21) Compilación condicional”…””}”(hj£h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj h²hh³hìh´Mœubh¼)”}”(hXUSiempre que sea posible, no use condicionales de preprocesador (#if, #ifdef) en archivos .c; de lo contrario, el código es más difícil de leer y la lógica más difícil de seguir. En cambio, use dichos condicionales en un archivo de encabezado que defina funciones para usar en esos archivos .c, proporcionando versiones de código auxiliar sin operación en el caso #else, y luego llame a estas funciones incondicionalmente desde archivos .c. El compilador evitará generar cualquier código para las llamadas restantes, produciendo resultados idénticos, pero la lógica es fácil de seguir.”h]”hXUSiempre que sea posible, no use condicionales de preprocesador (#if, #ifdef) en archivos .c; de lo contrario, el código es más difícil de leer y la lógica más difícil de seguir. En cambio, use dichos condicionales en un archivo de encabezado que defina funciones para usar en esos archivos .c, proporcionando versiones de código auxiliar sin operación en el caso #else, y luego llame a estas funciones incondicionalmente desde archivos .c. El compilador evitará generar cualquier código para las llamadas restantes, produciendo resultados idénticos, pero la lógica es fácil de seguir.”…””}”(hj±h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mžhj h²hubh¼)”}”(hX Prefiera compilar funciones completas, en lugar de porciones de funciones o porciones de expresiones. En lugar de poner un ifdef en una expresión, divida la totalidad de la expresión con una función de ayuda independiente y aplique el condicional a esa función.”h]”hX Prefiera compilar funciones completas, en lugar de porciones de funciones o porciones de expresiones. En lugar de poner un ifdef en una expresión, divida la totalidad de la expresión con una función de ayuda independiente y aplique el condicional a esa función.”…””}”(hj¿h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M§hj h²hubh¼)”}”(hX^Si tiene una función o variable que puede potencialmente quedar sin usar en una configuración en particular, y el compilador advertiría sobre su definición sin usar, marque la definición como __maybe_unused en lugar de envolverla en un preprocesador condicional. (Sin embargo, si una función o variable *siempre* acaba sin ser usada, bórrela.)”h]”(hX5Si tiene una función o variable que puede potencialmente quedar sin usar en una configuración en particular, y el compilador advertiría sobre su definición sin usar, marque la definición como __maybe_unused en lugar de envolverla en un preprocesador condicional. (Sin embargo, si una función o variable ”…””}”(hjÍh²hh³Nh´Nubjâ)”}”(hŒ *siempre*”h]”hŒsiempre”…””}”(hjÕh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jáhjÍubhŒ acaba sin ser usada, bórrela.)”…””}”(hjÍh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M¬hj h²hubh¼)”}”(hŒ¯Dentro del código, cuando sea posible, use la macro IS_ENABLED para convertir un símbolo Kconfig en una expresión booleana de C, y utilícelo en un condicional de C normal:”h]”hŒ¯Dentro del código, cuando sea posible, use la macro IS_ENABLED para convertir un símbolo Kconfig en una expresión booleana de C, y utilícelo en un condicional de C normal:”…””}”(hjíh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M²hj h²hubjŒ)”}”(hŒ1if (IS_ENABLED(CONFIG_SOMETHING)) { ... }”h]”hŒ1if (IS_ENABLED(CONFIG_SOMETHING)) { ... }”…””}”hjûsbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´M¶hj h²hubh¼)”}”(hXEl compilador "doblará"" constantemente el condicional e incluirá o excluirá el bloque de código al igual que con un #ifdef, por lo que esto no agregará ningún tiempo de gastos generales en ejecución. Sin embargo, este enfoque todavía permite que el compilador de C vea el código dentro del bloque, y verifique que sea correcto (sintaxis, tipos, símbolo, referencias, etc.). Por lo tanto, aún debe usar un #ifdef si el código dentro del bloque hace referencia a símbolos que no existirán si no se cumple la condición.”h]”hXEl compilador “doblaráâ€â€ constantemente el condicional e incluirá o excluirá el bloque de código al igual que con un #ifdef, por lo que esto no agregará ningún tiempo de gastos generales en ejecución. Sin embargo, este enfoque todavía permite que el compilador de C vea el código dentro del bloque, y verifique que sea correcto (sintaxis, tipos, símbolo, referencias, etc.). Por lo tanto, aún debe usar un #ifdef si el código dentro del bloque hace referencia a símbolos que no existirán si no se cumple la condición.”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M¼hj h²hubh¼)”}”(hŒÊAl final de cualquier bloque #if o #ifdef no trivial (más de unas pocas líneas), incluya un comentario después de #endif en la misma línea, anotando la expresión condicional utilizada. Por ejemplo:”h]”hŒÊAl final de cualquier bloque #if o #ifdef no trivial (más de unas pocas líneas), incluya un comentario después de #endif en la misma línea, anotando la expresión condicional utilizada. Por ejemplo:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MÄhj h²hubjŒ)”}”(hŒ9#ifdef CONFIG_SOMETHING ... #endif /* CONFIG_SOMETHING */”h]”hŒ9#ifdef CONFIG_SOMETHING ... #endif /* CONFIG_SOMETHING */”…””}”hj&sbah}”(h]”h ]”h"]”h$]”h&]”j›jœj‰jžjŸj }”uh1j‹h³hìh´MÈhj h²hubeh}”(h]”Œcompilacion-condicional”ah ]”h"]”Œ21) compilación condicional”ah$]”h&]”uh1j…hj‡h²hh³hìh´Mœubj†)”}”(hhh]”(j‹)”}”(hŒ22) No rompa el kernel”h]”hŒ22) No rompa el kernel”…””}”(hj@h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj=h²hh³hìh´MÏubh¼)”}”(hŒhEn general, la decisión de romper el kernel pertenece al usuario, más que al desarrollador del kernel.”h]”hŒhEn general, la decisión de romper el kernel pertenece al usuario, más que al desarrollador del kernel.”…””}”(hjNh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MÑhj=h²hubj†)”}”(hhh]”(j‹)”}”(hŒEvite el panic()”h]”hŒEvite el panic()”…””}”(hj_h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj\h²hh³hìh´MÕubh¼)”}”(hŒ¿panic() debe usarse con cuidado y principalmente solo durante el arranque del sistema. panic() es, por ejemplo, aceptable cuando se queda sin memoria durante el arranque y no puede continuar.”h]”hŒ¿panic() debe usarse con cuidado y principalmente solo durante el arranque del sistema. panic() es, por ejemplo, aceptable cuando se queda sin memoria durante el arranque y no puede continuar.”…””}”(hjmh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M×hj\h²hubeh}”(h]”Œevite-el-panic”ah ]”h"]”Œevite el panic()”ah$]”h&]”uh1j…hj=h²hh³hìh´MÕubj†)”}”(hhh]”(j‹)”}”(hŒUse WARN() en lugar de BUG()”h]”hŒUse WARN() en lugar de BUG()”…””}”(hj†h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjƒh²hh³hìh´MÜubh¼)”}”(hXJNo agregue código nuevo que use cualquiera de las variantes BUG(), como BUG(), BUG_ON() o VM_BUG_ON(). En su lugar, use una variante WARN*(), preferiblemente WARN_ON_ONCE(), y posiblemente con código de recuperación. El código de recuperación no es requerido si no hay una forma razonable de recuperar, al menos parcialmente.”h]”hXJNo agregue código nuevo que use cualquiera de las variantes BUG(), como BUG(), BUG_ON() o VM_BUG_ON(). En su lugar, use una variante WARN*(), preferiblemente WARN_ON_ONCE(), y posiblemente con código de recuperación. El código de recuperación no es requerido si no hay una forma razonable de recuperar, al menos parcialmente.”…””}”(hj”h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MÞhjƒh²hubh¼)”}”(hŒÕ"Soy demasiado perezoso para tener en cuenta los errores" no es una excusa para usar BUG(). Importantes corrupciones internas sin forma de continuar aún pueden usar BUG(), pero necesitan una buena justificación.”h]”hŒÙ“Soy demasiado perezoso para tener en cuenta los errores†no es una excusa para usar BUG(). Importantes corrupciones internas sin forma de continuar aún pueden usar BUG(), pero necesitan una buena justificación.”…””}”(hj¢h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mähjƒh²hubeh}”(h]”Œuse-warn-en-lugar-de-bug”ah ]”h"]”Œuse warn() en lugar de bug()”ah$]”h&]”uh1j…hj=h²hh³hìh´MÜubj†)”}”(hhh]”(j‹)”}”(hŒ1Use WARN_ON_ONCE() en lugar de WARN() o WARN_ON()”h]”hŒ1Use WARN_ON_ONCE() en lugar de WARN() o WARN_ON()”…””}”(hj»h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj¸h²hh³hìh´Méubh¼)”}”(hXGGeneralmente, se prefiere WARN_ON_ONCE() a WARN() o WARN_ON(), porque es común que una condición de advertencia dada, si ocurre, ocurra varias veces. Esto puede llenar el registro del kernel, e incluso puede ralentizar el sistema lo suficiente como para que el registro excesivo se convierta en su propio, adicional problema.”h]”hXGGeneralmente, se prefiere WARN_ON_ONCE() a WARN() o WARN_ON(), porque es común que una condición de advertencia dada, si ocurre, ocurra varias veces. Esto puede llenar el registro del kernel, e incluso puede ralentizar el sistema lo suficiente como para que el registro excesivo se convierta en su propio, adicional problema.”…””}”(hjÉh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mëhj¸h²hubeh}”(h]”Œ+use-warn-on-once-en-lugar-de-warn-o-warn-on”ah ]”h"]”Œ1use warn_on_once() en lugar de warn() o warn_on()”ah$]”h&]”uh1j…hj=h²hh³hìh´Méubj†)”}”(hhh]”(j‹)”}”(hŒNo haga WARN a la ligera”h]”hŒNo haga WARN a la ligera”…””}”(hjâh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjßh²hh³hìh´Mòubh¼)”}”(hXõWARN*() está diseñado para situaciones inesperadas que nunca deberían suceder. Las macros WARN*() no deben usarse para nada que se espera que suceda durante un funcionamiento normal. No hay "checkeos" previos o posteriores a la condición, por ejemplo. De nuevo: WARN*() no debe usarse para una condición esperada que vaya a activarse fácilmente, por ejemplo, mediante acciones en el espacio del usuario. pr_warn_once() es una alternativa posible, si necesita notificar al usuario de un problema.”h]”hXùWARN*() está diseñado para situaciones inesperadas que nunca deberían suceder. Las macros WARN*() no deben usarse para nada que se espera que suceda durante un funcionamiento normal. No hay “checkeos†previos o posteriores a la condición, por ejemplo. De nuevo: WARN*() no debe usarse para una condición esperada que vaya a activarse fácilmente, por ejemplo, mediante acciones en el espacio del usuario. pr_warn_once() es una alternativa posible, si necesita notificar al usuario de un problema.”…””}”(hjðh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Môhjßh²hubeh}”(h]”Œno-haga-warn-a-la-ligera”ah ]”h"]”Œno haga warn a la ligera”ah$]”h&]”uh1j…hj=h²hh³hìh´Mòubj†)”}”(hhh]”(j‹)”}”(hŒ.No se preocupe sobre panic_on_warn de usuarios”h]”hŒ.No se preocupe sobre panic_on_warn de usuarios”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjh²hh³hìh´Mýubh¼)”}”(hXbAlgunas palabras más sobre panic_on_warn: Recuerde que ``panic_on_warn`` es una opción disponible del kernel, y que muchos usuarios configuran esta opción. Esta es la razón por la que hay un artículo de "No haga WARN a la ligera", arriba. Sin embargo, la existencia de panic_on_warn de usuarios no es una razón válida para evitar el uso juicioso de WARN*(). Esto se debe a que quien habilita panic_on_warn, explícitamente pidió al kernel que fallara si se dispara un WARN*(), y tales usuarios deben estar preparados para afrontar las consecuencias de un sistema que es algo más probable que se rompa.”h]”(hŒ8Algunas palabras más sobre panic_on_warn: Recuerde que ”…””}”(hjh²hh³Nh´Nubj*)”}”(hŒ``panic_on_warn``”h]”hŒ panic_on_warn”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j)hjubhX es una opción disponible del kernel, y que muchos usuarios configuran esta opción. Esta es la razón por la que hay un artículo de “No haga WARN a la ligeraâ€, arriba. Sin embargo, la existencia de panic_on_warn de usuarios no es una razón válida para evitar el uso juicioso de WARN*(). Esto se debe a que quien habilita panic_on_warn, explícitamente pidió al kernel que fallara si se dispara un WARN*(), y tales usuarios deben estar preparados para afrontar las consecuencias de un sistema que es algo más probable que se rompa.”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mÿhjh²hubeh}”(h]”Œ.no-se-preocupe-sobre-panic-on-warn-de-usuarios”ah ]”h"]”Œ.no se preocupe sobre panic_on_warn de usuarios”ah$]”h&]”uh1j…hj=h²hh³hìh´Mýubj†)”}”(hhh]”(j‹)”}”(hŒ` del kernel, por greg@kroah.com at OLS 2002: http://www.kroah.com/linux/talks/ols_2002_kernel_codingstyle_talk/html/”h]”(h)”}”(hŒ-:ref:`process/coding-style.rst `”h]”hú)”}”(hjÛh]”hŒprocess/coding-style.rst”…””}”(hjÝh²hh³Nh´Nubah}”(h]”h ]”(jŒstd”Œstd-ref”eh"]”h$]”h&]”uh1hùhjÙubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jŒ refdomain”jçŒreftype”Œref”Œ refexplicit”ˆŒrefwarn”ˆjŒ codingstyle”uh1hh³hìh´M"hjÕubhŒ del kernel, por ”…””}”(hjÕh²hh³Nh´NubjJ)”}”(hŒgreg@kroah.com”h]”hŒgreg@kroah.com”…””}”(hjýh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:greg@kroah.com”uh1jIhjÕubhŒ at OLS 2002: ”…””}”(hjÕh²hh³Nh´NubjJ)”}”(hŒGhttp://www.kroah.com/linux/talks/ols_2002_kernel_codingstyle_talk/html/”h]”hŒGhttp://www.kroah.com/linux/talks/ols_2002_kernel_codingstyle_talk/html/”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”juh1jIhjÕubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M"hjnh²hubeh}”(h]”Œapendice-i-referencias”ah ]”h"]”Œapéndice i) referencias”ah$]”h&]”uh1j…hj‡h²hh³hìh´Mubeh}”(h]”(Œ$estilo-en-el-codigo-del-kernel-linux”j„eh ]”h"]”(Œ%estilo en el código del kernel linux”Œsp_codingstyle”eh$]”h&]”uh1j…hhh²hh³hìh´K Œexpect_referenced_by_name”}”j4jysŒexpect_referenced_by_id”}”j„jysubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hìuh1hŒcurrent_source”NŒ current_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(jŠNŒ generator”NŒ datestamp”NŒ source_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒ report_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j^Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hìŒ _destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒ raw_enabled”KŒline_length_limit”M'Œpep_references”NŒ pep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒ rfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œ smart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”j„]”jyasŒnameids”}”(j4j„j3j0j(j%j•j’j»j¸j³j°jUjRjŠ j‡ j€j}jxjujg jd jjjòjïjQjNjÂj¿j›j˜j,j)jÏjÌj¥j¢jj j±j®j,j)jjŠj jjjšj:j7jkjhj€j}jµj²jÜjÙjjj<j9jcj`j+j(uŒ nametypes”}”(j4ˆj3‰j(‰j•‰j»‰j³‰jU‰jŠ ‰j€‰jx‰jg ˆj‰jò‰jQ‰j‰j›‰j,‰jωj¥‰j‰j±‰j,‰j‰j ‰j‰j:‰jk‰j€‰jµ‰j܉j‰j<‰jc‰j+‰uh}”(j„j‡j0j‡j%jØj’j+j¸j˜j°j jRj¾j‡ jXj}j juj jd j^ jjƒjïj"jNjõj¿jTj˜jÅj)jžjÌj/j¢jÒj j¨j®jj)j´jŠj/jjjšjj7j jhj=j}j\j²jƒjÙj¸jjßj9jj`j?j(jnuŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œ collections”ŒCounter”“”}”…”R”Œparse_messages”]”hŒsystem_message”“”)”}”(hhh]”h¼)”}”(hŒ:Enumerated list start value not ordinal-1: "2" (ordinal 2)”h]”hŒ>Enumerated list start value not ordinal-1: “2†(ordinal 2)”…””}”(hjÆh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»hjÃubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”hìŒline”K uh1jÁhjžh²hh³hìh´MeubaŒtransform_messages”]”jÂ)”}”(hhh]”h¼)”}”(hhh]”hŒ4Hyperlink target "sp-codingstyle" is not referenced.”…””}”hjäsbah}”(h]”h ]”h"]”h$]”h&]”uh1h»hjáubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”jÜŒsource”hìŒline”Kuh1jÁubaŒ transformer”NŒ include_log”]”Œ9Documentation/translations/sp_SP/process/coding-style.rst”(NNNNt”†”aŒ decoration”Nh²hub.