€•ZóŒ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/deprecated”Œmodname”NŒ classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Simplified)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/zh_CN/process/deprecated”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/zh_TW/process/deprecated”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/it_IT/process/deprecated”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/ja_JP/process/deprecated”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/ko_KR/process/deprecated”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/pt_BR/process/deprecated”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubeh}”(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³ŒS/var/lib/git/docbuild/linux/Documentation/translations/sp_SP/process/deprecated.rst”h´KubhŒ field_body”“”)”}”(hŒ8:ref:`Documentation/process/deprecated.rst `”h]”h¼)”}”(hhñh]”h)”}”(hhñh]”hŒinline”“”)”}”(hhñh]”hŒ$Documentation/process/deprecated.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/deprecated”Œ refdomain”jŒreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆŒ reftarget”Œ deprecated”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Œ+Sergio Gonzalez ”h]”h¼)”}”(hŒ*Sergio Gonzalez ”h]”(hŒSergio Gonzalez <”…””}”(hjAh²hh³Nh´NubhŒ reference”“”)”}”(hŒsergio.collado@gmail.com”h]”hŒsergio.collado@gmail.com”…””}”(hjKh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:sergio.collado@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_deprecated:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œ sp-deprecated”uh1jwh´Khhh²hh³hìubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒMInterfaces obsoletos, CaracterÃsticas del lenguaje, Atributos y Convenciones”h]”hŒMInterfaces obsoletos, CaracterÃsticas del lenguaje, Atributos y Convenciones”…””}”(hjŒh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj‡h²hh³hìh´K ubh¼)”}”(hXÅEn un mundo perfecto, serÃa posible convertir todas las instancias de alguna API obsoleta en una nueva API y quitar la API anterior en un Ãºnico ciclo de desarrollo. Desafortunadamente, debido al tamaÃ±o del kernel, la jerarquÃa de mantenimiento, y el tiempo, no siempre es posible hacer estos cambios de una Ãºnica vez. Esto significa que las nuevas instancias han de ir creÃ¡ndose en el kernel, mientras que las antiguas se quitan, haciendo que la cantidad de trabajo para limpiar las APIs crezca. Para informar a los desarrolladores sobre quÃ© ha sido declarado obsoleto y por quÃ©, ha sido creada esta lista como un lugar donde indicar cuando los usos obsoletos son propuestos para incluir en el kernel.”h]”hXÅEn un mundo perfecto, serÃa posible convertir todas las instancias de alguna API obsoleta en una nueva API y quitar la API anterior en un Ãºnico ciclo de desarrollo. Desafortunadamente, debido al tamaÃ±o del kernel, la jerarquÃa de mantenimiento, y el tiempo, no siempre es posible hacer estos cambios de una Ãºnica vez. Esto significa que las nuevas instancias han de ir creÃ¡ndose en el kernel, mientras que las antiguas se quitan, haciendo que la cantidad de trabajo para limpiar las APIs crezca. Para informar a los desarrolladores sobre quÃ© ha sido declarado obsoleto y por quÃ©, ha sido creada esta lista como un lugar donde indicar cuando los usos obsoletos son propuestos para incluir en el kernel.”…””}”(hjšh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Khj‡h²hubj†)”}”(hhh]”(j‹)”}”(hŒ__deprecated”h]”hŒ__deprecated”…””}”(hj«h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj¨h²hh³hìh´Kubh¼)”}”(hXaMientras que este atributo seÃ±ala visualmente que un interface ha sido declarado obsoleto, este `no produce mÃ¡s avisos durante las compilaciones `_ porque uno de los objetivos del kernel es que compile sin avisos, y nadie ha hecho nada para quitar estos interfaces obsoletos. Mientras que usar `__deprecated` es sencillo para anotar una API obsoleta en un archivo de cabecera, no es la soluciÃ³n completa. Dichos interfaces deben o bien ser quitados por completo, o aÃ±adidos a este archivo para desanimar a otros a usarla en el futuro.”h]”(hŒaMientras que este atributo seÃ±ala visualmente que un interface ha sido declarado obsoleto, este ”…””}”(hj¹h²hh³Nh´NubjJ)”}”(hŒ{`no produce mÃ¡s avisos durante las compilaciones `_”h]”hŒ0no produce mÃ¡s avisos durante las compilaciones”…””}”(hjÁh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ0no produce mÃ¡s avisos durante las compilaciones”Œrefuri”ŒEhttps://git.kernel.org/linus/771c035372a036f83353eef46dbb829780330234”uh1jIhj¹ubjx)”}”(hŒH ”h]”h}”(h]”Œ/no-produce-mas-avisos-durante-las-compilaciones”ah ]”h"]”Œ0no produce mÃ¡s avisos durante las compilaciones”ah$]”h&]”Œrefuri”jÒuh1jwŒ referenced”Khj¹ubhŒ“ porque uno de los objetivos del kernel es que compile sin avisos, y nadie ha hecho nada para quitar estos interfaces obsoletos. Mientras que usar ”…””}”(hj¹h²hh³Nh´NubhŒtitle_reference”“”)”}”(hŒ`__deprecated`”h]”hŒ__deprecated”…””}”(hjçh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jåhj¹ubhŒä es sencillo para anotar una API obsoleta en un archivo de cabecera, no es la soluciÃ³n completa. Dichos interfaces deben o bien ser quitados por completo, o aÃ±adidos a este archivo para desanimar a otros a usarla en el futuro.”…””}”(hj¹h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Khj¨h²hubeh}”(h]”Œ deprecated”ah ]”h"]”Œ__deprecated”ah$]”h&]”uh1j…hj‡h²hh³hìh´Kubj†)”}”(hhh]”(j‹)”}”(hŒBUG() y BUG_ON()”h]”hŒBUG() y BUG_ON()”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjh²hh³hìh´K$ubh¼)”}”(hX_Use WARN() y WARN_ON() en su lugar, y gestione las condiciones de error "imposibles" tan elegantemente como se pueda. Mientras que la familia de funciones BUG() fueron originalmente diseÃ±adas para actuar como una "situaciÃ³n imposible", confirmar y disponer de un hilo del kernel de forma "segura", estas funciones han resultado ser demasiado arriesgadas. (e.g. "Â¿en quÃ© orden se necesitan liberar los locks? Â¿Se han restaurado sus estados?). La popular funciÃ³n BUG() desestabilizarÃ¡ el sistema o lo romperÃ¡ totalmente, lo cual hace imposible depurarlo o incluso generar reportes de crash. Linus tiene una `opiniÃ³n muy fuerte `_ y sentimientos `sobre esto `_.”h]”(hXsUse WARN() y WARN_ON() en su lugar, y gestione las condiciones de error â€œimposiblesâ€ tan elegantemente como se pueda. Mientras que la familia de funciones BUG() fueron originalmente diseÃ±adas para actuar como una â€œsituaciÃ³n imposibleâ€, confirmar y disponer de un hilo del kernel de forma â€œseguraâ€, estas funciones han resultado ser demasiado arriesgadas. (e.g. â€œÂ¿en quÃ© orden se necesitan liberar los locks? Â¿Se han restaurado sus estados?). La popular funciÃ³n BUG() desestabilizarÃ¡ el sistema o lo romperÃ¡ totalmente, lo cual hace imposible depurarlo o incluso generar reportes de crash. Linus tiene una ”…””}”(hjh²hh³Nh´NubjJ)”}”(hŒy`opiniÃ³n muy fuerte `_”h]”hŒopiniÃ³n muy fuerte”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”ŒopiniÃ³n muy fuerte”jÑŒ`https://lore.kernel.org/lkml/CA+55aFy6jNLsywVYdGp83AMrXBo_P-pkjkphPGrO=82SPKCpLQ@mail.gmail.com/”uh1jIhjubjx)”}”(hŒc ”h]”h}”(h]”Œopinion-muy-fuerte”ah ]”h"]”ŒopiniÃ³n muy fuerte”ah$]”h&]”Œrefuri”j0uh1jwjàKhjubhŒ y sentimientos ”…””}”(hjh²hh³Nh´NubjJ)”}”(hŒp`sobre esto `_”h]”hŒ sobre esto”…””}”(hjBh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ sobre esto”jÑŒ`https://lore.kernel.org/lkml/CAHk-=whDHsbK3HTOpTF=ue_o04onRwTEaK_ZoJp_fjbqq4+=Jw@mail.gmail.com/”uh1jIhjubjx)”}”(hŒc ”h]”h}”(h]”Œ sobre-esto”ah ]”h"]”Œ sobre esto”ah$]”h&]”Œrefuri”jRuh1jwjàKhjubhŒ.”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K%hjh²hubh¼)”}”(hXNÃ³tese que la familia de funciones WARN() Ãºnicamente deberÃa ser usada en situaciones que se "esperan no sean alcanzables". Si se quiere avisar sobre situaciones "alcanzables pero no deseadas", Ãºsese la familia de funciones pr_warn(). Los responsables del sistema pueden haber definido *panic_on_warn* sysctl para asegurarse que sus sistemas no continÃºan ejecutÃ¡ndose en presencia del condiciones "no alcanzables". (Por ejemplo, vÃ©ase commits como `este `_.)”h]”(hX*NÃ³tese que la familia de funciones WARN() Ãºnicamente deberÃa ser usada en situaciones que se â€œesperan no sean alcanzablesâ€. Si se quiere avisar sobre situaciones â€œalcanzables pero no deseadasâ€, Ãºsese la familia de funciones pr_warn(). Los responsables del sistema pueden haber definido ”…””}”(hjjh²hh³Nh´NubhŒemphasis”“”)”}”(hŒ*panic_on_warn*”h]”hŒ panic_on_warn”…””}”(hjth²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jrhjjubhŒš sysctl para asegurarse que sus sistemas no continÃºan ejecutÃ¡ndose en presencia del condiciones â€œno alcanzablesâ€. (Por ejemplo, vÃ©ase commits como ”…””}”(hjjh²hh³Nh´NubjJ)”}”(hŒO`este `_”h]”hŒeste”…””}”(hj†h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œeste”jÑŒEhttps://git.kernel.org/linus/d4689846881d160a4d12a514e991a740bcb5d65a”uh1jIhjjubjx)”}”(hŒH ”h]”h}”(h]”Œeste”ah ]”h"]”Œeste”ah$]”h&]”Œrefuri”j–uh1jwjàKhjjubhŒ.)”…””}”(hjjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K2hjh²hubeh}”(h]”Œbug-y-bug-on”ah ]”h"]”Œbug() y bug_on()”ah$]”h&]”uh1j…hj‡h²hh³hìh´K$ubj†)”}”(hhh]”(j‹)”}”(hŒ@Operaciones aritmÃ©ticas en los argumentos de reserva de memoria”h]”hŒ@Operaciones aritmÃ©ticas en los argumentos de reserva de memoria”…””}”(hj¹h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj¶h²hh³hìh´Kitem), GFP_KERNEL);”h]”hŒ\header = kzalloc(sizeof(*header) + count * sizeof(*header->item), GFP_KERNEL);”…””}”hj[sbah}”(h]”h ]”h"]”h$]”h&]”jjuh1jõh³hìh´K[hj¶h²hubh¼)”}”(hŒEn vez de eso emplee::”h]”hŒEn vez de eso emplee:”…””}”(hjih²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K^hj¶h²hubjö)”}”(hŒ?header = kzalloc(struct_size(header, item, count), GFP_KERNEL);”h]”hŒ?header = kzalloc(struct_size(header, item, count), GFP_KERNEL);”…””}”hjwsbah}”(h]”h ]”h"]”h$]”h&]”jjuh1jõh³hìh´K`hj¶h²hubhŒnote”“”)”}”(hŒ÷Si se usa struct_size() en una estructura que contiene un elemento de longitud cero o un array de un Ãºnico elemento como un array miembro, por favor reescribir ese uso y cambiar a un `miembro array flexible <#zero-length-and-one-element-arrays>`_”h]”h¼)”}”(hŒ÷Si se usa struct_size() en una estructura que contiene un elemento de longitud cero o un array de un Ãºnico elemento como un array miembro, por favor reescribir ese uso y cambiar a un `miembro array flexible <#zero-length-and-one-element-arrays>`_”h]”(hŒ¸Si se usa struct_size() en una estructura que contiene un elemento de longitud cero o un array de un Ãºnico elemento como un array miembro, por favor reescribir ese uso y cambiar a un ”…””}”(hj‹h²hh³Nh´NubjJ)”}”(hŒ?`miembro array flexible <#zero-length-and-one-element-arrays>`_”h]”hŒmiembro array flexible”…””}”(hj“h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œmiembro array flexible”jÑŒ##zero-length-and-one-element-arrays”uh1jIhj‹ubjx)”}”(hŒ& <#zero-length-and-one-element-arrays>”h]”h}”(h]”Œmiembro-array-flexible”ah ]”h"]”Œmiembro array flexible”ah$]”h&]”Œrefuri”j£uh1jwjàKhj‹ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kbhj‡ubah}”(h]”h ]”h"]”h$]”h&]”uh1j…hj¶h²hh³hìh´Nubh¼)”}”(hŒ€Para otros cÃ¡lculos, por favor use las funciones de ayuda: size_mul(), size_add(), and size_sub(). Por ejemplo, en el caso de::”h]”hŒPara otros cÃ¡lculos, por favor use las funciones de ayuda: size_mul(), size_add(), and size_sub(). Por ejemplo, en el caso de:”…””}”(hj½h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Khhj¶h²hubjö)”}”(hŒDfoo = krealloc(current_size + chunk_size * (count - 3), GFP_KERNEL);”h]”hŒDfoo = krealloc(current_size + chunk_size * (count - 3), GFP_KERNEL);”…””}”hjËsbah}”(h]”h ]”h"]”h$]”h&]”jjuh1jõh³hìh´Kkhj¶h²hubh¼)”}”(hŒRe-escrÃbase, como::”h]”hŒRe-escrÃbase, como:”…””}”(hjÙh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kmhj¶h²hubjö)”}”(hŒfoo = krealloc(size_add(current_size, size_mul(chunk_size, size_sub(count, 3))), GFP_KERNEL);”h]”hŒfoo = krealloc(size_add(current_size, size_mul(chunk_size, size_sub(count, 3))), GFP_KERNEL);”…””}”hjçsbah}”(h]”h ]”h"]”h$]”h&]”jjuh1jõh³hìh´Kohj¶h²hubh¼)”}”(hŒÑPara mÃ¡s detalles, mire tambiÃ©n array3_size() y flex_array_size(), como tambiÃ©n la familia de funciones relacionadas check_mul_overflow(), check_add_overflow(), check_sub_overflow(), y check_shl_overflow().”h]”hŒÑPara mÃ¡s detalles, mire tambiÃ©n array3_size() y flex_array_size(), como tambiÃ©n la familia de funciones relacionadas check_mul_overflow(), check_add_overflow(), check_sub_overflow(), y check_shl_overflow().”…””}”(hjõh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kshj¶h²hubeh}”(h]”Œ?operaciones-aritmeticas-en-los-argumentos-de-reserva-de-memoria”ah ]”h"]”Œ@operaciones aritmÃ©ticas en los argumentos de reserva de memoria”ah$]”h&]”uh1j…hj‡h²hh³hìh´K`_ para evitar avisos futuros en el compilador. Para casos que todavÃa necesitan cadenas de caracteres que se rellenen al final con el caracter NUL, usar strtomem_pad().”h]”(hŒ™Si una funciÃ³n usa cadenas de caracteres que no necesitan terminar en NUL, deberÃa usarse strtomem(), y el destino deberÃa seÃ±alarse con el atributo ”…””}”(hj˜h²hh³Nh´NubjJ)”}”(hŒS`__nonstring `_”h]”hŒ__nonstring”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ__nonstring”jÑŒBhttps://gcc.gnu.org/onlinedocs/gcc/Common-Variable-Attributes.html”uh1jIhj˜ubjx)”}”(hŒE ”h]”h}”(h]”Œ nonstring”ah ]”h"]”Œ__nonstring”ah$]”h&]”Œrefuri”j°uh1jwjàKhj˜ubhŒ¨ para evitar avisos futuros en el compilador. Para casos que todavÃa necesitan cadenas de caracteres que se rellenen al final con el caracter NUL, usar strtomem_pad().”…””}”(hj˜h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K¡hjkh²hubeh}”(h]”Œ2strncpy-en-cadenas-de-caracteres-terminadas-en-nul”ah ]”h"]”Œ4strncpy() en cadenas de caracteres terminadas en nul”ah$]”h&]”uh1j…hj‡h²hh³hìh´Kubj†)”}”(hhh]”(j‹)”}”(hŒ strlcpy()”h]”hŒ strlcpy()”…””}”(hjÓh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjÐh²hh³hìh´Kªubh¼)”}”(hXstrlcpy() primero lee por completo el buffer de origen (ya que el valor devuelto intenta ser el mismo que el de strlen()). Esta lectura puede sobrepasar el lÃmite de tamaÃ±o del destino. Esto ineficiente y puede causar desbordamientos de lectura si la cadena de origen no estÃ¡ terminada en el carÃ¡cter NUL. El reemplazo seguro de esta funciÃ³n es strscpy(), pero se ha de tener cuidado que en los casos en lso que se usase el valor devuelto de strlcpy(), ya que strscpy() devolverÃ¡ valores negativos de erno cuando se produzcan truncados.”h]”hXstrlcpy() primero lee por completo el buffer de origen (ya que el valor devuelto intenta ser el mismo que el de strlen()). Esta lectura puede sobrepasar el lÃmite de tamaÃ±o del destino. Esto ineficiente y puede causar desbordamientos de lectura si la cadena de origen no estÃ¡ terminada en el carÃ¡cter NUL. El reemplazo seguro de esta funciÃ³n es strscpy(), pero se ha de tener cuidado que en los casos en lso que se usase el valor devuelto de strlcpy(), ya que strscpy() devolverÃ¡ valores negativos de erno cuando se produzcan truncados.”…””}”(hjáh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K«hjÐh²hubeh}”(h]”Œstrlcpy”ah ]”h"]”Œ strlcpy()”ah$]”h&]”uh1j…hj‡h²hh³hìh´Kªubj†)”}”(hhh]”(j‹)”}”(hŒEspecificaciÃ³n de formato %p”h]”hŒEspecificaciÃ³n de formato %p”…””}”(hjúh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj÷h²hh³hìh´Kµubh¼)”}”(hX(Tradicionalmente,el uso de "%p" en el formato de cadenas de caracteres resultarÃa en exponer esas direcciones en dmesg, proc, sysfs, etc. En vez de dejar que sean una vulnerabilidad, todos los "%p" que se usan en el kernel se imprimen como un hash, haciÃ©ndolos efectivamente inutilizables para usarlos como direcciones de memoria. Nuevos usos de "%p" no deberÃan ser aÃ±adidos al kernel. Para textos de direcciones, usar "%pS" es mejor, ya que resulta en el nombre del sÃmbolo. Para prÃ¡cticamente el resto de casos, mejor no usar "%p" en absoluto.”h]”hX<Tradicionalmente,el uso de â€œ%pâ€ en el formato de cadenas de caracteres resultarÃa en exponer esas direcciones en dmesg, proc, sysfs, etc. En vez de dejar que sean una vulnerabilidad, todos los â€œ%pâ€ que se usan en el kernel se imprimen como un hash, haciÃ©ndolos efectivamente inutilizables para usarlos como direcciones de memoria. Nuevos usos de â€œ%pâ€ no deberÃan ser aÃ±adidos al kernel. Para textos de direcciones, usar â€œ%pSâ€ es mejor, ya que resulta en el nombre del sÃmbolo. Para prÃ¡cticamente el resto de casos, mejor no usar â€œ%pâ€ en absoluto.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K¶hj÷h²hubh¼)”}”(hŒ–Parafraseando las actuales `direcciones de Linus `_:”h]”(hŒParafraseando las actuales ”…””}”(hjh²hh³Nh´NubjJ)”}”(hŒz`direcciones de Linus `_”h]”hŒdirecciones de Linus”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œdirecciones de Linus”jÑŒ`https://lore.kernel.org/lkml/CA+55aFwQEd_d40g4mUCSsVRZzrFPUJt74vc6PPpb675hYNXcKw@mail.gmail.com/”uh1jIhjubjx)”}”(hŒc ”h]”h}”(h]”Œdirecciones-de-linus”ah ]”h"]”Œdirecciones de linus”ah$]”h&]”Œrefuri”j.uh1jwjàKhjubhŒ:”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´K¿hj÷h²hubhŒbullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒ“Si el valor "hasheado" "%p" no tienen ninguna finalidad, preguntarse si el puntero es realmente importante. Â¿QuizÃ¡s se podrÃa quitar totalmente?”h]”h¼)”}”(hŒ“Si el valor "hasheado" "%p" no tienen ninguna finalidad, preguntarse si el puntero es realmente importante. Â¿QuizÃ¡s se podrÃa quitar totalmente?”h]”hŒ›Si el valor â€œhasheadoâ€ â€œ%pâ€ no tienen ninguna finalidad, preguntarse si el puntero es realmente importante. Â¿QuizÃ¡s se podrÃa quitar totalmente?”…””}”(hjQh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KÁhjMubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhjHh²hh³hìh´NubjL)”}”(hXSi realmente se piensa que el valor del puntero es importante, Â¿porquÃ© algÃºn estado del sistema o nivel de privilegio de usuario es considerado "especial"? Si piensa que puede justificarse (en comentarios y mensajes del commit), de forma suficiente como para pasar el escrutinio de Linux, quizÃ¡s pueda usar el "%p", a la vez que se asegura que tiene los permisos correspondientes. ”h]”h¼)”}”(hX€Si realmente se piensa que el valor del puntero es importante, Â¿porquÃ© algÃºn estado del sistema o nivel de privilegio de usuario es considerado "especial"? Si piensa que puede justificarse (en comentarios y mensajes del commit), de forma suficiente como para pasar el escrutinio de Linux, quizÃ¡s pueda usar el "%p", a la vez que se asegura que tiene los permisos correspondientes.”h]”hXˆSi realmente se piensa que el valor del puntero es importante, Â¿porquÃ© algÃºn estado del sistema o nivel de privilegio de usuario es considerado â€œespecialâ€? Si piensa que puede justificarse (en comentarios y mensajes del commit), de forma suficiente como para pasar el escrutinio de Linux, quizÃ¡s pueda usar el â€œ%pâ€, a la vez que se asegura que tiene los permisos correspondientes.”…””}”(hjih²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KÃhjeubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhjHh²hh³hìh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jFh³hìh´KÁhj÷h²hubh¼)”}”(hŒåSi estÃ¡ depurando algo donde el "%p" hasheado estÃ¡ causando problemas, se puede arrancar temporalmente con la opciÃ³n de depuraciÃ³n "`no_hash_pointers `_".”h]”(hŒŽSi estÃ¡ depurando algo donde el â€œ%pâ€ hasheado estÃ¡ causando problemas, se puede arrancar temporalmente con la opciÃ³n de depuraciÃ³n â€œ”…””}”(hj…h²hh³Nh´NubjJ)”}”(hŒ[`no_hash_pointers `_”h]”hŒno_hash_pointers”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œno_hash_pointers”jÑŒEhttps://git.kernel.org/linus/5ead723a20e0447bc7db33dc3070b420e5f80aa6”uh1jIhj…ubjx)”}”(hŒH ”h]”h}”(h]”Œno-hash-pointers”ah ]”h"]”Œno_hash_pointers”ah$]”h&]”Œrefuri”juh1jwjàKhj…ubhŒâ€.”…””}”(hj…h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KÊhj÷h²hubeh}”(h]”Œespecificacion-de-formato-p”ah ]”h"]”ŒespecificaciÃ³n de formato %p”ah$]”h&]”uh1j…hj‡h²hh³hìh´Kµubj†)”}”(hhh]”(j‹)”}”(hŒ"Arrays de longitud variable (VLAs)”h]”hŒ"Arrays de longitud variable (VLAs)”…””}”(hjÀh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj½h²hh³hìh´KÐubh¼)”}”(hX~Usando VLA en la pila (stack) produce un cÃ³digo mucho peor que los arrays de tamaÃ±o estÃ¡tico. Mientras que estos errores no triviales de `rendimiento `_ son razÃ³n suficiente para no usar VLAs, esto ademÃ¡s son un riesgo de seguridad. El crecimiento dinÃ¡mico del array en la pila, puede exceder la memoria restante en el segmento de la pila. Esto podrÃa llevara a un fallo, posible sobre-escritura de contenido al final de la pila (cuando se construye sin `CONFIG_THREAD_INFO_IN_TASK=y`), o sobre-escritura de la memoria adyacente a la pila (cuando se construye sin `CONFIG_VMAP_STACK=y`).”h]”(hŒŒUsando VLA en la pila (stack) produce un cÃ³digo mucho peor que los arrays de tamaÃ±o estÃ¡tico. Mientras que estos errores no triviales de ”…””}”(hjÎh²hh³Nh´NubjJ)”}”(hŒ:`rendimiento `_”h]”hŒrendimiento”…””}”(hjÖh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œrendimiento”jÑŒ)https://git.kernel.org/linus/02361bc77888”uh1jIhjÎubjx)”}”(hŒ, ”h]”h}”(h]”Œrendimiento”ah ]”h"]”Œrendimiento”ah$]”h&]”Œrefuri”jæuh1jwjàKhjÎubhX3 son razÃ³n suficiente para no usar VLAs, esto ademÃ¡s son un riesgo de seguridad. El crecimiento dinÃ¡mico del array en la pila, puede exceder la memoria restante en el segmento de la pila. Esto podrÃa llevara a un fallo, posible sobre-escritura de contenido al final de la pila (cuando se construye sin ”…””}”(hjÎh²hh³Nh´Nubjæ)”}”(hŒ`CONFIG_THREAD_INFO_IN_TASK=y`”h]”hŒCONFIG_THREAD_INFO_IN_TASK=y”…””}”(hjøh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jåhjÎubhŒP), o sobre-escritura de la memoria adyacente a la pila (cuando se construye sin ”…””}”(hjÎh²hh³Nh´Nubjæ)”}”(hŒ`CONFIG_VMAP_STACK=y`”h]”hŒCONFIG_VMAP_STACK=y”…””}”(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´KÑhj½h²hubeh}”(h]”Œ arrays-de-longitud-variable-vlas”ah ]”h"]”Œ"arrays de longitud variable (vlas)”ah$]”h&]”uh1j…hj‡h²hh³hìh´KÐubj†)”}”(hhh]”(j‹)”}”(hŒ#Switch case fall-through implÃcito”h]”hŒ#Switch case fall-through implÃcito”…””}”(hj-h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj*h²hh³hìh´KÝubh¼)”}”(hX˜El lenguaje C permite a las sentencias 'switch' saltar de un caso al siguiente caso cuando la sentencia de ruptura "break" no aparece al final del caso. Esto, introduce ambigÃ¼edad en el cÃ³digo, ya que no siempre estÃ¡ claro si el 'break' que falta es intencionado o un olvido. Por ejemplo, no es obvio solamente mirando al cÃ³digo si `STATE_ONE` estÃ¡ escrito para intencionadamente saltar en `STATE_TWO`::”h]”(hX\El lenguaje C permite a las sentencias â€˜switchâ€™ saltar de un caso al siguiente caso cuando la sentencia de ruptura â€œbreakâ€ no aparece al final del caso. Esto, introduce ambigÃ¼edad en el cÃ³digo, ya que no siempre estÃ¡ claro si el â€˜breakâ€™ que falta es intencionado o un olvido. Por ejemplo, no es obvio solamente mirando al cÃ³digo si ”…””}”(hj;h²hh³Nh´Nubjæ)”}”(hŒ`STATE_ONE`”h]”hŒ STATE_ONE”…””}”(hjCh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jåhj;ubhŒ0 estÃ¡ escrito para intencionadamente saltar en ”…””}”(hj;h²hh³Nh´Nubjæ)”}”(hŒ`STATE_TWO`”h]”hŒ STATE_TWO”…””}”(hjUh²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´KÞhj*h²hubjö)”}”(hŒ‰switch (value) { case STATE_ONE: do_something(); case STATE_TWO: do_other(); break; default: WARN("unknown state"); }”h]”hŒ‰switch (value) { case STATE_ONE: do_something(); case STATE_TWO: do_other(); break; default: WARN("unknown state"); }”…””}”hjmsbah}”(h]”h ]”h"]”h$]”h&]”jjuh1jõh³hìh´Kåhj*h²hubh¼)”}”(hXYa que ha habido una larga lista de defectos `debidos a declaraciones de "break" que faltan `_, no se permiten 'fall-through' implÃcitos. Para identificar 'fall-through' intencionados, se ha adoptado la pseudo-palabra-clave macro "falltrhrough", que expande las extensiones de gcc `__attribute__((__fallthrough__)) `_. (Cuando la sintaxis de C17/c18 `[[fallthrough]]` sea mÃ¡s comÃºnmente soportadas por los compiladores de C, analizadores estÃ¡ticos, e IDEs, se puede cambiar a usar esa sintaxis para esa pseudo-palabra-clave.”h]”(hŒ-Ya que ha habido una larga lista de defectos ”…””}”(hj{h²hh³Nh´NubjJ)”}”(hŒb`debidos a declaraciones de "break" que faltan `_”h]”hŒ1debidos a declaraciones de â€œbreakâ€ que faltan”…””}”(hjƒh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ-debidos a declaraciones de "break" que faltan”jÑŒ/https://cwe.mitre.org/data/definitions/484.html”uh1jIhj{ubjx)”}”(hŒ2 ”h]”h}”(h]”Œ+debidos-a-declaraciones-de-break-que-faltan”ah ]”h"]”Œ-debidos a declaraciones de "break" que faltan”ah$]”h&]”Œrefuri”j“uh1jwjàKhj{ubhŒÈ, no se permiten â€˜fall-throughâ€™ implÃcitos. Para identificar â€˜fall-throughâ€™ intencionados, se ha adoptado la pseudo-palabra-clave macro â€œfalltrhroughâ€, que expande las extensiones de gcc ”…””}”(hj{h²hh³Nh´NubjJ)”}”(hŒb`__attribute__((__fallthrough__)) `_”h]”hŒ __attribute__((__fallthrough__))”…””}”(hj¥h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ __attribute__((__fallthrough__))”jÑŒ”h]”h}”(h]”Œattribute-fallthrough”ah ]”h"]”Œ __attribute__((__fallthrough__))”ah$]”h&]”Œrefuri”jµuh1jwjàKhj{ubhŒ!. (Cuando la sintaxis de C17/c18 ”…””}”(hj{h²hh³Nh´Nubjæ)”}”(hŒ`[[fallthrough]]`”h]”hŒ[[fallthrough]]”…””}”(hjÇh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jåhj{ubhŒ sea mÃ¡s comÃºnmente soportadas por los compiladores de C, analizadores estÃ¡ticos, e IDEs, se puede cambiar a usar esa sintaxis para esa pseudo-palabra-clave.”…””}”(hj{h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kïhj*h²hubh¼)”}”(hŒ5Todos los bloques switch/case deben acabar en uno de:”h]”hŒ5Todos los bloques switch/case deben acabar en uno de:”…””}”(hjßh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kùhj*h²hubjG)”}”(hhh]”(jL)”}”(hŒbreak;”h]”h¼)”}”(hjòh]”hŒbreak;”…””}”(hjôh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kûhjðubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhjíh²hh³hìh´NubjL)”}”(hŒfallthrough;”h]”h¼)”}”(hj h]”hŒfallthrough;”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kühjubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhjíh²hh³hìh´NubjL)”}”(hŒ continue;”h]”h¼)”}”(hj h]”hŒ continue;”…””}”(hj"h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kýhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhjíh²hh³hìh´NubjL)”}”(hŒ goto ;”h]”h¼)”}”(hj7h]”hŒ goto ;”…””}”(hj9h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Kþhj5ubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhjíh²hh³hìh´NubjL)”}”(hŒreturn [expression]; ”h]”h¼)”}”(hŒreturn [expression];”h]”hŒreturn [expression];”…””}”(hjPh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´KÿhjLubah}”(h]”h ]”h"]”h$]”h&]”uh1jKhjíh²hh³hìh´Nubeh}”(h]”h ]”h"]”h$]”h&]”jƒŒ*”uh1jFh³hìh´Kûhj*h²hubeh}”(h]”Œ"switch-case-fall-through-implicito”ah ]”h"]”Œ#switch case fall-through implÃcito”ah$]”h&]”uh1j…hj‡h²hh³hìh´KÝubj†)”}”(hhh]”(j‹)”}”(hŒ%Arrays de longitud cero y un elemento”h]”hŒ%Arrays de longitud cero y un elemento”…””}”(hjvh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjsh²hh³hìh´Mubh¼)”}”(hXzHay una necesidad habitual en el kernel de proveer una forma para declarar un grupo de elementos consecutivos de tamaÃ±o dinÃ¡mico en una estructura. El cÃ³digo del kernel deberÃa usar siempre `"miembros array flexible" `_ en estos casos. El estilo anterior de arrays de un elemento o de longitud cero, no deben usarse mÃ¡s.”h]”(hŒÂHay una necesidad habitual en el kernel de proveer una forma para declarar un grupo de elementos consecutivos de tamaÃ±o dinÃ¡mico en una estructura. El cÃ³digo del kernel deberÃa usar siempre ”…””}”(hj„h²hh³Nh´NubjJ)”}”(hŒR`"miembros array flexible" `_”h]”hŒâ€œmiembros array flexibleâ€”…””}”(hjŒh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ"miembros array flexible"”jÑŒ3https://en.wikipedia.org/wiki/Flexible_array_member”uh1jIhj„ubjx)”}”(hŒ6 ”h]”h}”(h]”Œmiembros-array-flexible”ah ]”h"]”Œ"miembros array flexible"”ah$]”h&]”Œrefuri”jœuh1jwjàKhj„ubhŒf en estos casos. El estilo anterior de arrays de un elemento o de longitud cero, no deben usarse mÃ¡s.”…””}”(hj„h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhjsh²hubh¼)”}”(hŒ˜En el cÃ³digo C mÃ¡s antiguo, los elementos finales de tamaÃ±o dinÃ¡mico se obtenÃan especificando un array de un elemento al final de una estructura::”h]”hŒ—En el cÃ³digo C mÃ¡s antiguo, los elementos finales de tamaÃ±o dinÃ¡mico se obtenÃan especificando un array de un elemento al final de una estructura:”…””}”(hj´h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M hjsh²hubjö)”}”(hŒHstruct something { size_t count; struct foo items[1]; };”h]”hŒHstruct something { size_t count; struct foo items[1]; };”…””}”hjÂsbah}”(h]”h ]”h"]”h$]”h&]”jjuh1jõh³hìh´M hjsh²hubh¼)”}”(hŒšEn cÃ³digo C mÃ¡s antiguo, elementos seguidos de tamaÃ±o dinÃ¡mico eran creados especificando una array de un Ãºnico elemento al final de una estructura::”h]”hŒ™En cÃ³digo C mÃ¡s antiguo, elementos seguidos de tamaÃ±o dinÃ¡mico eran creados especificando una array de un Ãºnico elemento al final de una estructura:”…””}”(hjÐh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhjsh²hubjö)”}”(hŒHstruct something { size_t count; struct foo items[1]; };”h]”hŒHstruct something { size_t count; struct foo items[1]; };”…””}”hjÞsbah}”(h]”h ]”h"]”h$]”h&]”jjuh1jõh³hìh´Mhjsh²hubh¼)”}”(hX‰Esto llevÃ³ a resultados incorrectos en los cÃ¡lculos de tamaÃ±o mediante sizeof() (el cual hubiera necesitado eliminar el tamaÃ±o del Ãºltimo elemento para tener un tamaÃ±o correcto de la "cabecera"). Una `extensiÃ³n de GNU C `_ se empezÃ³ a usar para permitir los arrays de longitud cero, para evitar estos tipos de problemas de tamaÃ±o::”h]”(hŒÒEsto llevÃ³ a resultados incorrectos en los cÃ¡lculos de tamaÃ±o mediante sizeof() (el cual hubiera necesitado eliminar el tamaÃ±o del Ãºltimo elemento para tener un tamaÃ±o correcto de la â€œcabeceraâ€). Una ”…””}”(hjìh²hh³Nh´NubjJ)”}”(hŒL`extensiÃ³n de GNU C `_”h]”hŒextensiÃ³n de GNU C”…””}”(hjôh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”ŒextensiÃ³n de GNU C”jÑŒ3https://gcc.gnu.org/onlinedocs/gcc/Zero-Length.html”uh1jIhjìubjx)”}”(hŒ6 ”h]”h}”(h]”Œextension-de-gnu-c”ah ]”h"]”ŒextensiÃ³n de gnu c”ah$]”h&]”Œrefuri”juh1jwjàKhjìubhŒn se empezÃ³ a usar para permitir los arrays de longitud cero, para evitar estos tipos de problemas de tamaÃ±o:”…””}”(hjìh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mhjsh²hubjö)”}”(hŒHstruct something { size_t count; struct foo items[0]; };”h]”hŒHstruct something { size_t count; struct foo items[0]; };”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”jjuh1jõh³hìh´M!hjsh²hubh¼)”}”(hXFPero esto llevÃ³ a otros problemas, y no solucionÃ³ algunos otros problemas compartidos por ambos estilos, como no ser capaz de detectar cuando ese array accidentalmente _no_ es usado al final de la estructura (lo que podÃa pasar directamente, o cuando dicha estructura era usada en uniones, estructuras de estructuras, etc).”h]”hXFPero esto llevÃ³ a otros problemas, y no solucionÃ³ algunos otros problemas compartidos por ambos estilos, como no ser capaz de detectar cuando ese array accidentalmente _no_ es usado al final de la estructura (lo que podÃa pasar directamente, o cuando dicha estructura era usada en uniones, estructuras de estructuras, etc).”…””}”(hj*h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M&hjsh²hubh¼)”}”(hŒxC99 introdujo "los arrays miembros flexibles", los cuales carecen de un tamaÃ±o numÃ©rico en su declaraciÃ³n del array::”h]”hŒ{C99 introdujo â€œlos arrays miembros flexiblesâ€, los cuales carecen de un tamaÃ±o numÃ©rico en su declaraciÃ³n del array:”…””}”(hj8h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M,hjsh²hubjö)”}”(hŒGstruct something { size_t count; struct foo items[]; };”h]”hŒGstruct something { size_t count; struct foo items[]; };”…””}”hjFsbah}”(h]”h ]”h"]”h$]”h&]”jjuh1jõh³hìh´M/hjsh²hubh¼)”}”(hX¤Esta es la forma en la que el kernel espera que se declaren los elementos de tamaÃ±o dinÃ¡mico concatenados. Esto permite al compilador generar errores, cuando el array flexible no es declarado en el Ãºltimo lugar de la estructura, lo que ayuda a prevenir errores en Ã©l cÃ³digo del tipo `comportamiento indefinido `_. Esto tambiÃ©n permite al compilador analizar correctamente los tamaÃ±os de los arrays (via sizeof(), `CONFIG_FORTIFY_SOURCE`, y `CONFIG_UBSAN_BOUNDS`). Por ejemplo, si no hay un mecanismo que avise que el siguiente uso de sizeof() en un array de longitud cero, siempre resulta en cero::”h]”(hX Esta es la forma en la que el kernel espera que se declaren los elementos de tamaÃ±o dinÃ¡mico concatenados. Esto permite al compilador generar errores, cuando el array flexible no es declarado en el Ãºltimo lugar de la estructura, lo que ayuda a prevenir errores en Ã©l cÃ³digo del tipo ”…””}”(hjTh²hh³Nh´NubjJ)”}”(hŒd`comportamiento indefinido `_”h]”hŒcomportamiento indefinido”…””}”(hj\h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œcomportamiento indefinido”jÑŒEhttps://git.kernel.org/linus/76497732932f15e7323dc805e8ea8dc11bb587cf”uh1jIhjTubjx)”}”(hŒH ”h]”h}”(h]”Œcomportamiento-indefinido”ah ]”h"]”Œcomportamiento indefinido”ah$]”h&]”Œrefuri”jluh1jwjàKhjTubhŒg. Esto tambiÃ©n permite al compilador analizar correctamente los tamaÃ±os de los arrays (via sizeof(), ”…””}”(hjTh²hh³Nh´Nubjæ)”}”(hŒ`CONFIG_FORTIFY_SOURCE`”h]”hŒCONFIG_FORTIFY_SOURCE”…””}”(hj~h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jåhjTubhŒ, y ”…””}”(hjTh²hh³Nh´Nubjæ)”}”(hŒ`CONFIG_UBSAN_BOUNDS`”h]”hŒCONFIG_UBSAN_BOUNDS”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jåhjTubhŒˆ). Por ejemplo, si no hay un mecanismo que avise que el siguiente uso de sizeof() en un array de longitud cero, siempre resulta en cero:”…””}”(hjTh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´M4hjsh²hubjö)”}”(hXstruct something { size_t count; struct foo items[0]; }; struct something *instance; instance = kmalloc(struct_size(instance, items, count), GFP_KERNEL); instance->count = count; size = sizeof(instance->items) * instance->count; memcpy(instance->items, source, size);”h]”hXstruct something { size_t count; struct foo items[0]; }; struct something *instance; instance = kmalloc(struct_size(instance, items, count), GFP_KERNEL); instance->count = count; size = sizeof(instance->items) * instance->count; memcpy(instance->items, source, size);”…””}”hj¨sbah}”(h]”h ]”h"]”h$]”h&]”jjuh1jõh³hìh´M>hjsh²hubh¼)”}”(hX¼En la Ãºltima lÃnea del cÃ³digo anterior, ``zero`` vale ``cero``, cuando uno podrÃa esperar que representa el tamaÃ±o total en bytes de la memoria dinÃ¡mica reservada para el array consecutivo ``items``. AquÃ hay un par de ejemplos mÃ¡s sobre este tema: `link 1 `_, `link 2 `_. Sin embargo, los array de miembros flexibles tienen un type incompleto, y no se ha de aplicar el operador sizeof()`_, asÃ cualquier mal uso de dichos operadores serÃ¡ detectado inmediatamente en el momento de compilaciÃ³n.”h]”(hŒ+En la Ãºltima lÃnea del cÃ³digo anterior, ”…””}”(hj¶h²hh³Nh´NubhŒliteral”“”)”}”(hŒ``zero``”h]”hŒzero”…””}”(hjÀh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¾hj¶ubhŒ vale ”…””}”(hj¶h²hh³Nh´Nubj¿)”}”(hŒ``cero``”h]”hŒcero”…””}”(hjÒh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¾hj¶ubhŒ‚, cuando uno podrÃa esperar que representa el tamaÃ±o total en bytes de la memoria dinÃ¡mica reservada para el array consecutivo ”…””}”(hj¶h²hh³Nh´Nubj¿)”}”(hŒ ``items``”h]”hŒitems”…””}”(hjäh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¾hj¶ubhŒ6. AquÃ hay un par de ejemplos mÃ¡s sobre este tema: ”…””}”(hj¶h²hh³Nh´NubjJ)”}”(hŒQ`link 1 `_”h]”hŒlink 1”…””}”(hjöh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œlink 1”jÑŒEhttps://git.kernel.org/linus/f2cd32a443da694ac4e28fbf4ac6f9d5cc63a539”uh1jIhj¶ubjx)”}”(hŒH ”h]”h}”(h]”Œlink-1”ah ]”h"]”Œlink 1”ah$]”h&]”Œrefuri”j uh1jwjàKhj¶ubhŒ, ”…””}”(hj¶h²hh³Nh´NubjJ)”}”(hŒQ`link 2 `_”h]”hŒlink 2”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œlink 2”jÑŒEhttps://git.kernel.org/linus/ab91c2a89f86be2898cee208d492816ec238b2cf”uh1jIhj¶ubjx)”}”(hŒH ”h]”h}”(h]”Œlink-2”ah ]”h"]”Œlink 2”ah$]”h&]”Œrefuri”j( uh1jwjàKhj¶ubhŒu. Sin embargo, los array de miembros flexibles tienen un type incompleto, y no se ha de aplicar el operador sizeof()<”…””}”(hj¶h²hh³Nh´NubjJ)”}”(hŒ3https://gcc.gnu.org/onlinedocs/gcc/Zero-Length.html”h]”hŒ3https://gcc.gnu.org/onlinedocs/gcc/Zero-Length.html”…””}”(hj: h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j< uh1jIhj¶ubhŒn>`_, asÃ cualquier mal uso de dichos operadores serÃ¡ detectado inmediatamente en el momento de compilaciÃ³n.”…””}”(hj¶h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MKhjsh²hubh¼)”}”(hXÔCon respecto a los arrays de un Ãºnico elemento, se ha de ser consciente de que dichos arrays ocupan al menos tanto espacio como un Ãºnico objeto del tipo https://gcc.gnu.org/onlinedocs/gcc/Zero-Length.html>`_, de ahÃ que estos contribuyan al tamaÃ±o de la estructura que los contiene. Esto es proclive a errores cada vez que se quiere calcular el tamaÃ±o total de la memoria dinÃ¡mica para reservar una estructura que contenga un array de este tipo como su miembro::”h]”(hŒ›Con respecto a los arrays de un Ãºnico elemento, se ha de ser consciente de que dichos arrays ocupan al menos tanto espacio como un Ãºnico objeto del tipo ”…””}”(hjS h²hh³Nh´NubjJ)”}”(hŒ3https://gcc.gnu.org/onlinedocs/gcc/Zero-Length.html”h]”hŒ3https://gcc.gnu.org/onlinedocs/gcc/Zero-Length.html”…””}”(hj[ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j] uh1jIhjS ubhX>`_, de ahÃ que estos contribuyan al tamaÃ±o de la estructura que los contiene. Esto es proclive a errores cada vez que se quiere calcular el tamaÃ±o total de la memoria dinÃ¡mica para reservar una estructura que contenga un array de este tipo como su miembro:”…””}”(hjS h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´MWhjsh²hubjö)”}”(hX"struct something { size_t count; struct foo items[1]; }; struct something *instance; instance = kmalloc(struct_size(instance, items, count - 1), GFP_KERNEL); instance->count = count; size = sizeof(instance->items) * instance->count; memcpy(instance->items, source, size);”h]”hX"struct something { size_t count; struct foo items[1]; }; struct something *instance; instance = kmalloc(struct_size(instance, items, count - 1), GFP_KERNEL); instance->count = count; size = sizeof(instance->items) * instance->count; memcpy(instance->items, source, size);”…””}”hjt sbah}”(h]”h ]”h"]”h$]”h&]”jjuh1jõh³hìh´M_hjsh²hubh¼)”}”(hX‰En el ejemplo anterior, hemos de recordar calcular ``count - 1``, cuando se usa la funciÃ³n de ayuda struct_size(), de otro modo estarÃamos --desintencionadamente--reservando memoria para un ``items`` de mÃ¡s. La forma mÃ¡s clara y menos proclive a errores es implementar esto mediante el uso de `array miembro flexible`, junto con las funciones de ayuda: struct_size() y flex_array_size()::”h]”(hŒ3En el ejemplo anterior, hemos de recordar calcular ”…””}”(hj‚ h²hh³Nh´Nubj¿)”}”(hŒ ``count - 1``”h]”hŒ count - 1”…””}”(hjŠ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¾hj‚ ubhŒ, cuando se usa la funciÃ³n de ayuda struct_size(), de otro modo estarÃamos --desintencionadamente--reservando memoria para un ”…””}”(hj‚ h²hh³Nh´Nubj¿)”}”(hŒ ``items``”h]”hŒitems”…””}”(hjœ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¾hj‚ ubhŒ` de mÃ¡s. La forma mÃ¡s clara y menos proclive a errores es implementar esto mediante el uso de ”…””}”(hj‚ h²hh³Nh´Nubjæ)”}”(hŒ`array miembro flexible`”h]”hŒarray miembro flexible”…””}”(hj® h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jåhj‚ ubhŒF, junto con las funciones de ayuda: struct_size() y flex_array_size():”…””}”(hj‚ h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h»h³hìh´Mlhjsh²hubjö)”}”(hXstruct something { size_t count; struct foo items[]; }; struct something *instance; instance = kmalloc(struct_size(instance, items, count), GFP_KERNEL); instance->count = count; memcpy(instance->items, source, flex_array_size(instance, items, instance->count));”h]”hXstruct something { size_t count; struct foo items[]; }; struct something *instance; instance = kmalloc(struct_size(instance, items, count), GFP_KERNEL); instance->count = count; memcpy(instance->items, source, flex_array_size(instance, items, instance->count));”…””}”hjÆ sbah}”(h]”h ]”h"]”h$]”h&]”jjuh1jõh³hìh´Mshjsh²hubeh}”(h]”Œ%arrays-de-longitud-cero-y-un-elemento”ah ]”h"]”Œ%arrays de longitud cero y un elemento”ah$]”h&]”uh1j…hj‡h²hh³hìh´Mubeh}”(h]”(ŒJinterfaces-obsoletos-caracteristicas-del-lenguaje-atributos-y-convenciones”j„eh ]”h"]”(ŒMinterfaces obsoletos, caracterÃsticas del lenguaje, atributos y convenciones”Œ sp_deprecated”eh$]”h&]”uh1j…hhh²hh³hìh´K Œexpect_referenced_by_name”}”jâ jysŒ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”}”(jâ j„já jÞ jjjÜjÙj³j°j:j7j\jYj jjjjjªj/j,jhjejÍjÊjºj·jôjñjºj·j8j5j§j¤j'j$jðjíjpjmjjšj¿j¼jÙ jÖ j¦j£jjjvjsj j j2 j/ uŒ nametypes”}”(jâ ˆjá ‰j‰jÜˆj³‰j:ˆj\ˆj ˆj‰jˆj/‰jh‰jÍ‰jºˆjô‰jº‰j8ˆj§ˆj'‰jðˆjp‰jˆj¿ˆjÙ ‰j¦ˆjˆjvˆj ˆj2 ˆuh}”(j„j‡jÞ j‡jj¨jÙjÓj°jj7j1jYjSjj—jj¶jªj¤j,jjej2jÊjkj·j±jñjÐj·j÷j5j/j¤jžj$j½jíjçjmj*jšj”j¼j¶jÖ jsj£jjjjsjmj j j/ j) uŒ 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”]”Œtransform_messages”]”hŒsystem_message”“”)”}”(hhh]”h¼)”}”(hhh]”hŒ3Hyperlink target "sp-deprecated" is not referenced.”…””}”hjv sbah}”(h]”h ]”h"]”h$]”h&]”uh1h»hjs ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”hìŒline”Kuh1jq ubaŒtransformer”NŒinclude_log”]”Œ7Documentation/translations/sp_SP/process/deprecated.rst”(NNNNt”†”aŒ decoration”Nh²hub.