sp_SP/process/deprecated.rst

13 alguna API obsoleta en una nueva API y quitar la API anterior en un
17 han de ir creándose en el kernel, mientras que las antiguas se quitan,
21 obsoletos son propuestos para incluir en el kernel.
30 que usar `__deprecated` es sencillo para anotar una API obsoleta en
33 desanimar a otros a usarla en el futuro.
37 Use WARN() y WARN_ON() en su lugar, y gestione las condiciones de error
42 "¿en qué orden se necesitan liberar los locks? ¿Se han restaurado sus
51 en situaciones que se "esperan no sean alcanzables". Si se quiere
55 ejecutándose en presencia del condiciones "no alcanzables". (Por ejemplo,
59 Operaciones aritméticas en los argumentos de reserva de memoria
62 deberían realizarse en los argumentos de reserva de memoria (o similares)
65 uso de esas reservas puede llevar a desbordamientos en el 'heap' de memoria
68 De todos modos, el método recomendado en estos caso es reescribir el código
69 como se sugiere a continuación para evitar las operaciones aritméticas en
72 Por ejemplo, no utilice `count * size`` como argumento, como en::
84 saturan, en caso de desbordamiento::
89 la suma de otras estructuras, como en::
98 .. note:: Si se usa struct_size() en una estructura que contiene un elemento
105 size_add(), and size_sub(). Por ejemplo, en el caso de::
127 cadena de caracteres termine en NUL o en el carácter de línea nueva.
133 Esto puede resultar en desbordamientos lineals más allá del fin del buffer,
138 en el el valor retornado por strcpy() sea usado, ya que strscpy() no
143 strncpy() en cadenas de caracteres terminadas en NUL
145 El uso de strncpy() no garantiza que el buffer de destino esté terminado en
146 NUL. Esto puede causar varios errores de desbordamiento en lectura y otros
147 tipos de funcionamiento erróneo debido a que falta la terminación en NUL.
148 Esta función también termina la cadena de caracteres en NUL en el buffer de
151 función con cadenas de caracteres que sí están terminadas en NUL.
153 Cuando se necesita que la cadena de destino sea terminada en NUL,
155 cuidado en los casos en los que el valor de strncpy() fuera usado, ya que
159 ser terminado en el caracter nulo, debería usar strscpy_pad().
161 Si una función usa cadenas de caracteres que no necesitan terminar en NUL,
165 para evitar avisos futuros en el compilador. Para casos que todavía
174 desbordamientos de lectura si la cadena de origen no está terminada en el
176 de tener cuidado que en los casos en lso que se usase el valor devuelto de
182 Tradicionalmente,el uso de "%p" en el formato de cadenas de caracteres
183 resultaría en exponer esas direcciones en dmesg, proc, sysfs, etc. En vez
184 de dejar que sean una vulnerabilidad, todos los "%p" que se usan en el
188 mejor, ya que resulta en el nombre del símbolo. Para prácticamente el
189 resto de casos, mejor no usar "%p" en absoluto.
197   "especial"? Si piensa que puede justificarse (en comentarios y mensajes
209 Usando VLA en la pila (stack) produce un código mucho peor que los arrays
213 dinámico del array en la pila, puede exceder la memoria restante en
224 del caso. Esto, introduce ambigüedad en el código, ya que no siempre está
227 intencionadamente saltar en `STATE_TWO`::
249 Todos los bloques switch/case deben acabar en uno de:
260 Hay una necesidad habitual en el kernel de proveer una forma para declarar
261 un grupo de elementos consecutivos de tamaño dinámico en una estructura.
262 El código del kernel debería usar siempre `"miembros array flexible" <https://en.wikipedia.org/wiki…
263 en estos casos. El estilo anterior de arrays de un elemento o de longitud
282 Esto llevó a resultados incorrectos en los cálculos de tamaño mediante
297 directamente, o cuando dicha estructura era usada en uniones, estructuras
301 tamaño numérico en su declaración del array::
308 Esta es la forma en la que el kernel espera que se declaren los elementos
310 errores, cuando el array flexible no es declarado en el último lugar de la
311 estructura, lo que ayuda a prevenir errores en él código del tipo
316 sizeof() en un array de longitud cero, siempre resulta en cero::
332 podría esperar que representa el tamaño total en bytes de la memoria dinámica
340 así cualquier mal uso de dichos operadores será detectado inmediatamente en