sp_SP/process/adding-syscalls.rst

8 Agregando una Nueva Llamada del Sistema
11 Este documento describe qué involucra agregar una nueva llamada del sistema
19 La primera cosa a considerar cuando se agrega una llamada al sistema es si
46    Evite agregar cualquier API a debugfs, ya que no se considera una
51    podría ser más apropiada. Sin embargo, :manpage:`fcntl(2)` es una
69 ser soportada indefinidamente. Como tal, es una muy buena idea discutir
93 argumentos, es preferible encapsular la mayoría de los argumentos en una
114    un kernel más nuevo, el código del kernel puede extender con ceros, una
153 debería considerar también si una versión :manpage:`xyzzyat(2)` es mas
161 efectivamente dando una operación :manpage:`fxyzzy(3)` gratis::
175 Si su nueva llamada de sistema  :manpage:`xyzzy` involucra una
177 bit linux apropiada (revisado con una llamada a ``capable()``), como se
178 describe en el man page :manpage:`capabilities(7)`. Elija una parte de
186 no es el proceso invocado, este debería ser restringido (usando una llamada
195 aplica si el argumento es parte de una estructura que se pasa a través de
201 Para hacer una nueva llamada al sistema fácil de revisar, es mejor dividir
209  - Conectar la nueva llamada a sistema a una arquitectura particular,
240 una tabla de syscall genéricas. Agrega su nueva llamada de sistema a la
241 lista genérica agregando una entrada a la lista en
252 El archivo ``kernel/sys_ni.c`` provee una implementación fallback stub
259 debería normalmente ser opcional, así que incluya una opción ``CONFIG``
263  - Incluya una descripción para la nueva funcionalidad y llamada al sistema
275  - una opción ``CONFIG`` para la nueva función, normalmente en ``init/Kconfig``
287 sistema ni es especial de alguna manera (revise abajo), esto involucra una
293 y una entrada "i386" en ``arch/x86/entry/syscalls/syscall_32.tbl``::
309 Sin embargo, existe un par de situaciones donde se necesita una capa de
325 La segunda situación que requiere una capa de compatibilidad es cuando uno
329 desde una aplicación de 32-bit se separará en dos valores de 32-bit, los
332 (Note que un argumento de una llamada a sistema que sea un puntero a un
333 type explicitamente de 64-bit **no** necesita una capa de compatibilidad;
335 ``loff_t __user *`` no significan la necesidad de una llamada a sistema
345 o ambas llaman a una función de implementación interna común.)
353 Si la nueva llamada al sistema involucra una estructura que que se dispone
356 include/linux/compat.h también debería incluir una versión compatible de la
360 esta estructura ``compat_`` para analizar los argumentos de una invocación
391   - una ``COMPAT_SYSCALL_DEFINEn(xyzzy, ...)`` para el punto de entrada de compat.
394   - una instancia de ``__SC_COMP`` no ``__SYSCALL`` en ``include/uapi/asm-generic/unistd.h``
399 Para conectar la arquitectura x86 de una llamada al sistema con una versión
404 una columna extra para indicar que un programa del userspace de 32-bit
410 la nueva llamada al sistema. Aquí hay una elección: el diseño de los
435 Para la mayoría de las llamadas al sistema, una vez que se la llamada al
442 Estas podrían retornar a una ubicación distinta (``rt_sigreturn``) o
468 Si la llamada a sistema necesita una capa de compatibilidad (como en la
477 stub_xyzzy, pero el UML construido no incluye una implementación
498 Más generalmente, si existe una llamada al sistema que sea análoga a su
508 proveer a los revisores con una demostración de cómo los programas del
513 Para una nueva llamada al sistema, obviamente no habrá una función
515 ``syscall()``; también, si la llamada al sistema involucra una nueva
536 usa groff, es útil incluir una versión ASCII pre-renderizada del man-page
553 antiguas, o necesita ser compartida entre una syscall y su variante de
554 compatibilidad, esta debería ser implementada mediante una función "helper"
561 kernel. Este usa una convención de llamada diferente para llamadas al
565 una syscall específica son pasados durante la entrada del syscall, en vez
572 cual llamar a ``sys_xyzzy()`` es generalmente una mala idea.
585  - Artículo LWN de Michael Kerrisk sobre cómo manejar flags desconocidos en una
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
616    argumentos deben encapsular estos argumentos en una estructura, la cual incluye