sp_SP/process/adding-syscalls.rst

13 :ref:`Documentation/process/submitting-patches.rst <submittingpatches>` que
22 tradicionales, existen otras posibilidades -- elija la que mejor se adecúe
25  - Si se puede hacer que la operación se parezca a un objeto filesystem,
28    funcionalidad en un módulo del kernel en vez de requerir que sea
32        notifica al userspace que algo ha pasado, entonces retornar un nuevo
36      - Sin embargo, operaciones que no mapean a operaciones similares a
37        :manpage:`read(2)`/:manpage:`write(2)` tienen que ser implementadas
44    requiere que el filesystem relevante esté montado, lo que podría no ser
46    Evite agregar cualquier API a debugfs, ya que no se considera una
52    llamada al sistema multiplexada que esconde mucha complejidad, así que
61    complicado así que está reservado para comandos análogamente cercanos
68 Una nueva llamada del sistema forma parte del API del kernel, y tiene que
76 ``pipe``/``pipe2``, ``renameat``/``renameat2`` -- así que aprenda de la
79 Para llamadas al sistema más simples que sólo toman un par de argumentos,
81 flag a la llamada al sistema. Para asegurarse que el userspace pueda usar
89 (Si no hay valores de flags usados aún, revise que los argumentos del flag
92 Para llamadas al sistema más sofisticadas que involucran un gran número de
94 estructura que sea pasada a través de un puntero. Tal estructura puede
105 Siempre que cualquier campo añadido subsecuente, digamos ``param_4``, sea
106 diseñado de forma tal que un valor cero, devuelva el comportamiento previo,
110    llamadas a un kernel más antiguo, el código del kernel debe revisar que
112    de manera efectiva que ``param_4 == 0``).
132 descriptor de archivo, entonces el argumento flag debe incluir un valor que
138 la constante ``O_CLOEXEC``, ya que es específica de la arquitectura y es
139 parte de un espacio numerado de flags ``O_*`` que está bastante lleno.)
142 considerar también que significa usar la familia de llamadas de sistema
144 archivo listo para leer o escribir es la forma normal para que el kernel
145 indique al espacio de usuario que un evento ha ocurrido en el
172 tipo ``loff_t`` para que movimientos de 64-bit puedan ser soportados
179 capability linux que govierne las funcionalidades relacionadas, pero trate
181 misma sección, ya que va en contra de los propósitos de las capabilities de
185 Si su nueva llamada de sistema :manpage:`xyzzy(2)` manipula un proceso que
187 a ``ptrace_may_access()``) de forma que el único proceso con los mismos
191 Finalmente, debe ser conciente de que algunas arquitecturas no-x86 tienen
192 un manejo más sencillo si los parámetros que son explícitamente 64-bit
195 aplica si el argumento es parte de una estructura que se pasa a través de
234 para calzar en la manera en que las llamadas de sistema son invocadas::
248 sistema adicional, y note que si multiples llamadas de sistema nuevas son
250 tener que ser ajustada para resolver conflictos.
258 Su nueva funcionalidad del kernel, y la llamada de sistema que la controla,
259 debería normalmente ser opcional, así que incluya una opción ``CONFIG``
267  - Haga que cualquier nuevo archivo fuente que implemente la función
270  - Revise dos veces que el kernel se siga compilando con la nueva opción
273 Para resumir, necesita un commit que incluya:
286 actualizar las tablas maestras syscall. Asumiendo que su nueva llamada de
315 que podrían tener valores tanto 32-bit como 64-bit. En particular esto se
316 necesita siempre que un argumento de la llamada a sistema es:
325 La segunda situación que requiere una capa de compatibilidad es cuando uno
326 de los argumentos de la llamada a sistema tiene un argumento que es
328 ``loff_t`` o ``__u64``. En este caso, el valor que llega a un kernel 64-bit
330 que luego necesitan ser reensamblados en la capa de compatibilidad.
332 (Note que un argumento de una llamada a sistema que sea un puntero a un
342 pero espera recibir parametros con valores 32-bit y hace lo que tenga que
349 para igualar la forma en que las llamadas al sistema son invocadas::
353 Si la nueva llamada al sistema involucra una estructura que que se dispone
358 variable tiene el tipo ``compat_`` apropiado que corresponde al tipo en
404 una columna extra para indicar que un programa del userspace de 32-bit
409 Segundo, tienes que averiguar qué debería pasar para la versión x32 ABI de
415 ILP32, por lo que el diseño debe coincidir con la versión 32-bit, y la
416 entrada en ``arch/x86/entry/syscalls/syscall_64.tbl`` se divide para que
427 En cualquier caso, debes revisar que lo tipos involucrados en su diseño de
435 Para la mayoría de las llamadas al sistema, una vez que se la llamada al
438 los registros igual que antes de la llamada al sistema, y con el mismo
452 assembly que guardan/restauran registros adicionales e invocan el punto de
473 invocar un stub que llame a la versión ``compat_sys_``
475 Para completar, también es agradable configurar un mapeo de modo que el
488 está la excepción ocasional que pueda requerir actualización para su
492 (arch-specific) que clasifican algunos tipos especiales de llamadas al
498 Más generalmente, si existe una llamada al sistema que sea análoga a su
500 kernel de la llamada a sistema existente, para revisar que no exista otro
514 envoltorio libc por lo que el test necesitará ser invocado usando
519 Asegure que selftest corra satisfactoriamente en todas las arquitecturas
563 envoltorio syscall que luego entrega el procesamiento al syscall real. Esto
564 significa que sólo aquellos parámetros que son realmente necesarios para
589  - Par de artículos LWN de David Drysdale que describen la ruta de implementación
604  - Recomendaciones de Andrew Morton que toda la información relacionada a una nueva
607  - Recomendaciones de Michael Kerrisk que una nueva llamada al sistema debe venir
609  - Sugerencias de Thomas Gleixner que conexiones x86 deben ir en commits
611  - Sugerencias de Greg Kroah-Hartman que es bueno para las nueva llamadas al sistema
612    que vengan con man-page y selftest: https://lore.kernel.org/r/20140320025530.GA25469@kroah.com
615  - Sugerencias de Ingo Molnar que llamadas al sistema que involucran múltiples
630  - Recomendaciones de Linus Torvalds que las llamadas al sistema x32 deben favorecer