sp_SP/process/adding-syscalls.rst

12 al kernel Linux, más allá de la presentación y consejos normales en
20 alguna alternativa es adecuada en su lugar. Aunque las llamadas al sistema
28    funcionalidad en un módulo del kernel en vez de requerir que sea
41  - Si sólo está exponiendo información del runtime, un nuevo nodo en sysfs
45    siempre el caso (e.g. en un ambiente namespaced/sandboxed/chrooted).
70 explícitamente el interface en las listas de correo del kernel, y es
93 argumentos, es preferible encapsular la mayoría de los argumentos en una
96 tamaño en la estructura::
107 entonces permite versiones no coincidentes en ambos sentidos:
118 Revise :manpage:`perf_event_open(2)` y la función ``perf_copy_attr()`` (en
133 sea equivalente a definir ``O_CLOEXEC`` en el nuevo FD. Esto hace posible
136 ``execve()`` en otro hilo podrían filtrar un descriptor al programa
143 :manpage:`poll(2)` en ese descriptor de archivo. Hacer un descriptor de
145 indique al espacio de usuario que un evento ha ocurrido en el
158 Esto permite más flexibilidad en como el userspace especifica el archivo en
159 cuestión; en particular esto permite al userspace pedir la funcionalidad a
173 incluso en arquitecturas de 32-bit.
178 describe en el man page :manpage:`capabilities(7)`. Elija una parte de
181 misma sección, ya que va en contra de los propósitos de las capabilities de
193 caigan en argumentos enumerados impares (i.e. parámetros 1,3,5), para
202 el patchset (conjunto de parches) en trozos separados. Estos deberían
211  - Una demostración del use de la nueva llamada a sistema en el userspace
212    vía un selftest en ``tools/testing/selftest/``.
214    texto plano en la carta de presentación, o como un parche (separado)
226 ``SYSCALL_DEFINEn()`` apropiada en vez de explicitamente. El 'n' indica el
233 correspondiente en ``include/linux/syscalls.h``,  marcado como asmlinkage
234 para calzar en la manera en que las llamadas de sistema son invocadas::
241 lista genérica agregando una entrada a la lista en
249 añadidas en la misma ventana unida, su nueva llamada de sistema podría
260 (tipicamente en ``init/Kconfig``) para ella. Como es usual para opciones
268    dependa de la opción CONFIG en el Makefile (e.g.
275  - una opción ``CONFIG`` para la nueva función, normalmente en ``init/Kconfig``
277  - El correspondiente prototipo en ``include/linux/syscalls.h``
278  - Una entrada genérica en ``include/uapi/asm-generic/unistd.h``
279  - fallback stub en ``kernel/sys_ni.c``
288 entrada "común" (para x86_64 y x86_32) en
293 y una entrada "i386" en ``arch/x86/entry/syscalls/syscall_32.tbl``::
297 De nuevo, estos número son propensos de ser cambiados si hay conflictos en
305 ser invocada incluso cuando el programa de userspace es en si mismo 32-bit;
329 desde una aplicación de 32-bit se separará en dos valores de 32-bit, los
330 que luego necesitan ser reensamblados en la capa de compatibilidad.
348 correspondiente, en ``include/linux/compat.h``, marcado como asmlinkage
349 para igualar la forma en que las llamadas al sistema son invocadas::
354 de forma distinta en sistema de 32-bit y 64-bit, digamos
358 variable tiene el tipo ``compat_`` apropiado que corresponde al tipo en
372 en struct xyzzy_args, entonces struct compat_xyzzy_args debe tener::
382 permitir la versión compat; la entrada en
383 ``include/uapi/asm-generic/unistd.h`` debería usar ``__SC_COMP`` en vez de
392   - el prototipo correspondiente en ``include/linux/compat.h``
393   - (en caso de ser necesario) un struct de mapeo de 32-bit en ``include/linux/compat.h``
394   - una instancia de ``__SC_COMP`` no ``__SYSCALL`` en ``include/uapi/asm-generic/unistd.h``
400 de compatibilidad, las entradas en las tablas de syscall deben ser
403 Primero, la entrada en ``arch/x86/entry/syscalls/syscall_32.tbl`` recibe
405 corriendo en un kernel de 64-bit debe llegar al punto de entrada compat::
416 entrada en ``arch/x86/entry/syscalls/syscall_64.tbl`` se divide para que
424 call 64-bit para el x32 ABI  (y consecuentemente la entrada en
427 En cualquier caso, debes revisar que lo tipos involucrados en su diseño de
437 quedó -- en la siguiente instrucción, con el stack igual y la mayoría de
439 espacio en la memoria virtual.
456 en ``arch/x86/entry/entry_64.S``, y la entrada en la tabla syscall
461 El equivalente para programas 32-bit corriendo en un kernel 64-bit es
462 normalmente llamado ``stub32_xyzzy`` e implementado en
463 ``arch/x86/entry/entry_64_compat.S``, con el correspondiente ajuste en la
464 tabla syscall en ``arch/x86/syscalls/syscall_32.tbl``::
468 Si la llamada a sistema necesita una capa de compatibilidad (como en la
470 versión ``compat_sys_`` de la llamada a sistema, en vez de la versión
510 objetivos es incluir un simple programa self-test en un nuevo directorio
519 Asegure que selftest corra satisfactoriamente en todas las arquitecturas
537 en el cover del email para el patchset, para la conveniencia de los
544 No invoque las llamadas de sistemas en el kernel
551 otro lugar en el kernel. Si la funcionalidad syscall es útil para ser usada
559 Al menos en 64-bit x86, será un requerimiento duro desde la v4.17 en
560 adelante no invocar funciones de llamada al sistema (system call) en el
562 sistema donde ``struct pt_regs`` es decodificado on-the-fly en un
565 una syscall específica son pasados durante la entrada del syscall, en vez
566 de llenar en seis registros de CPU con contenido random del userspace todo
574 Excepciones a esta regla están permitidas solamente en overrides
576 arquitectura, u otro código en arch/.
582  - Artículo LWN de Michael Kerrisk sobre el uso de argumentos flags en llamadas al
585  - Artículo LWN de Michael Kerrisk sobre cómo manejar flags desconocidos en una
587  - Artículo LWN de Jake Edge describiendo restricciones en argumentos en
590    de llamadas al sistema en detalle para v3.14:
595  - Requerimientos arquitectura-específicos para llamadas al sistema son discutidos en el
605    llamada al sistema debe venir en el mismo hilo de correos:
609  - Sugerencias de Thomas Gleixner que conexiones x86 deben ir en commits
616    argumentos deben encapsular estos argumentos en una estructura, la cual incluye
626  - Discusión de Matthew Wilcox sobre las restricciones en argumentos 64-bit: