€•@Œ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/adding-syscalls”Œ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/adding-syscalls”Œ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/adding-syscalls”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ+/translations/it_IT/process/adding-syscalls”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ+/translations/ja_JP/process/adding-syscalls”Œ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/adding-syscalls”Œ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ŸŒX/var/lib/git/docbuild/linux/Documentation/translations/sp_SP/process/adding-syscalls.rst”h KubhŒ field_body”“”)”}”(hŒ>:ref:`Documentation/process/adding-syscalls.rst `”h]”h¨)”}”(hhÝh]”h)”}”(hhÝh]”hŒinline”“”)”}”(hhÝh]”hŒ)Documentation/process/adding-syscalls.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/adding-syscalls”Œ refdomain”hòŒreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆŒ reftarget”Œaddsyscalls”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”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhjhŸhØh KubhÚ)”}”(hŒ(Mauricio Fuentes ”h]”h¨)”}”(hŒ'Mauricio Fuentes ”h]”(hŒMauricio Fuentes <”…””}”(hj-hžhhŸNh NubhŒ reference”“”)”}”(hŒmauriciofb@gmail.com”h]”hŒmauriciofb@gmail.com”…””}”(hj7hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:mauriciofb@gmail.com”uh1j5hj-ubhŒ>”…””}”(hj-hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Khj)ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙhjubeh}”(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_addsyscalls:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œsp-addsyscalls”uh1jch KhhhžhhŸhØubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ'Agregando una Nueva Llamada del Sistema”h]”hŒ'Agregando una Nueva Llamada del Sistema”…””}”(hjxhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhjshžhhŸhØh K ubh¨)”}”(hXEste documento describe quÃ© involucra agregar una nueva llamada del sistema al kernel Linux, mÃ¡s allÃ¡ de la presentaciÃ³n y consejos normales en :ref:`Documentation/process/submitting-patches.rst ` que tambiÃ©n puede encontrar traducido a este idioma.”h]”(hŒ”Este documento describe quÃ© involucra agregar una nueva llamada del sistema al kernel Linux, mÃ¡s allÃ¡ de la presentaciÃ³n y consejos normales en ”…””}”(hj†hžhhŸNh Nubh)”}”(hŒG:ref:`Documentation/process/submitting-patches.rst `”h]”hæ)”}”(hjh]”hŒ,Documentation/process/submitting-patches.rst”…””}”(hj’hžhhŸNh Nubah}”(h]”h ]”(hñŒstd”Œstd-ref”eh"]”h$]”h&]”uh1håhjŽubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”hþŒ refdomain”jœŒreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆjŒsubmittingpatches”uh1hhŸhØh Khj†ubhŒ6 que tambiÃ©n puede encontrar traducido a este idioma.”…””}”(hj†hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Khjshžhubjr)”}”(hhh]”(jw)”}”(hŒ#Alternativas a Llamadas del Sistema”h]”hŒ#Alternativas a Llamadas del Sistema”…””}”(hj»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhj¸hžhhŸhØh Kubh¨)”}”(hX<La primera cosa a considerar cuando se agrega una llamada al sistema es si alguna alternativa es adecuada en su lugar. Aunque las llamadas al sistema son los puntos de interacciÃ³n entre el userspace y el kernel mÃ¡s obvios y tradicionales, existen otras posibilidades -- elija la que mejor se adecÃºe a su interfaz.”h]”hX<La primera cosa a considerar cuando se agrega una llamada al sistema es si alguna alternativa es adecuada en su lugar. Aunque las llamadas al sistema son los puntos de interacciÃ³n entre el userspace y el kernel mÃ¡s obvios y tradicionales, existen otras posibilidades -- elija la que mejor se adecÃºe a su interfaz.”…””}”(hjÉhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Khj¸hžhubhŒblock_quote”“”)”}”(hXé- Si se puede hacer que la operaciÃ³n se parezca a un objeto filesystem, podrÃa tener mÃ¡s sentido crear un nuevo sistema de ficheros o dispositivo. Esto tambiÃ©n harÃ¡ mÃ¡s fÃ¡cil encapsular la nueva funcionalidad en un mÃ³dulo del kernel en vez de requerir que sea construido junto al kernel principal. - Si la nueva funcionalidad involucra operaciones donde el kernel notifica al userspace que algo ha pasado, entonces retornar un nuevo descriptor de archivo para el objeto relevante permite al userspace usar ``poll``/``select``/``epoll`` para recibir esta notificaciÃ³n. - Sin embargo, operaciones que no mapean a operaciones similares a :manpage:`read(2)`/:manpage:`write(2)` tienen que ser implementadas como solicitudes :manpage:`ioctl(2)`, las cuales pueden llevar a un API algo opaca. - Si sÃ³lo estÃ¡ exponiendo informaciÃ³n del runtime, un nuevo nodo en sysfs (mire ``Documentation/filesystems/sysfs.rst``) o el filesystem ``/proc`` podrÃa ser mÃ¡s adecuado. Sin embargo, acceder a estos mecanismos requiere que el filesystem relevante estÃ© montado, lo que podrÃa no ser siempre el caso (e.g. en un ambiente namespaced/sandboxed/chrooted). Evite agregar cualquier API a debugfs, ya que no se considera una interfaz (interface) de 'producciÃ³n' para el userspace. - Si la operaciÃ³n es especÃfica a un archivo o descriptor de archivo especÃfico, entonces la opciÃ³n de comando adicional :manpage:`fcntl(2)` podrÃa ser mÃ¡s apropiada. Sin embargo, :manpage:`fcntl(2)` es una llamada al sistema multiplexada que esconde mucha complejidad, asÃ que esta opciÃ³n es mejor cuando la nueva funcion es analogamente cercana a la funcionalidad existente :manpage:`fcntl(2)`, o la nueva funcionalidad es muy simple (por ejemplo, definir/obtener un flag simple relacionado a un descriptor de archivo). - Si la operaciÃ³n es especÃfica a un proceso o tarea particular, entonces un comando adicional :manpage:`prctl(2)` podrÃa ser mÃ¡s apropiado. Tal como con :manpage:`fcntl(2)`, esta llamada al sistema es un multiplexor complicado asÃ que estÃ¡ reservado para comandos anÃ¡logamente cercanos del existente ``prctl()`` u obtener/definir un flag simple relacionado a un proceso. ”h]”hŒbullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hX8Si se puede hacer que la operaciÃ³n se parezca a un objeto filesystem, podrÃa tener mÃ¡s sentido crear un nuevo sistema de ficheros o dispositivo. Esto tambiÃ©n harÃ¡ mÃ¡s fÃ¡cil encapsular la nueva funcionalidad en un mÃ³dulo del kernel en vez de requerir que sea construido junto al kernel principal. - Si la nueva funcionalidad involucra operaciones donde el kernel notifica al userspace que algo ha pasado, entonces retornar un nuevo descriptor de archivo para el objeto relevante permite al userspace usar ``poll``/``select``/``epoll`` para recibir esta notificaciÃ³n. - Sin embargo, operaciones que no mapean a operaciones similares a :manpage:`read(2)`/:manpage:`write(2)` tienen que ser implementadas como solicitudes :manpage:`ioctl(2)`, las cuales pueden llevar a un API algo opaca. ”h]”(h¨)”}”(hX/Si se puede hacer que la operaciÃ³n se parezca a un objeto filesystem, podrÃa tener mÃ¡s sentido crear un nuevo sistema de ficheros o dispositivo. Esto tambiÃ©n harÃ¡ mÃ¡s fÃ¡cil encapsular la nueva funcionalidad en un mÃ³dulo del kernel en vez de requerir que sea construido junto al kernel principal.”h]”hX/Si se puede hacer que la operaciÃ³n se parezca a un objeto filesystem, podrÃa tener mÃ¡s sentido crear un nuevo sistema de ficheros o dispositivo. Esto tambiÃ©n harÃ¡ mÃ¡s fÃ¡cil encapsular la nueva funcionalidad en un mÃ³dulo del kernel en vez de requerir que sea construido junto al kernel principal.”…””}”(hjèhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh KhjäubjØ)”}”(hX÷- Si la nueva funcionalidad involucra operaciones donde el kernel notifica al userspace que algo ha pasado, entonces retornar un nuevo descriptor de archivo para el objeto relevante permite al userspace usar ``poll``/``select``/``epoll`` para recibir esta notificaciÃ³n. - Sin embargo, operaciones que no mapean a operaciones similares a :manpage:`read(2)`/:manpage:`write(2)` tienen que ser implementadas como solicitudes :manpage:`ioctl(2)`, las cuales pueden llevar a un API algo opaca. ”h]”jÞ)”}”(hhh]”(jã)”}”(hX Si la nueva funcionalidad involucra operaciones donde el kernel notifica al userspace que algo ha pasado, entonces retornar un nuevo descriptor de archivo para el objeto relevante permite al userspace usar ``poll``/``select``/``epoll`` para recibir esta notificaciÃ³n. ”h]”h¨)”}”(hXSi la nueva funcionalidad involucra operaciones donde el kernel notifica al userspace que algo ha pasado, entonces retornar un nuevo descriptor de archivo para el objeto relevante permite al userspace usar ``poll``/``select``/``epoll`` para recibir esta notificaciÃ³n.”h]”(hŒÎSi la nueva funcionalidad involucra operaciones donde el kernel notifica al userspace que algo ha pasado, entonces retornar un nuevo descriptor de archivo para el objeto relevante permite al userspace usar ”…””}”(hjhžhhŸNh NubhŒliteral”“”)”}”(hŒ``poll``”h]”hŒpoll”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒ/”…””}”(hjhžhhŸNh Nubj )”}”(hŒ ``select``”h]”hŒselect”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒ/”…””}”hjsbj )”}”(hŒ ``epoll``”h]”hŒepoll”…””}”(hj/hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒ! para recibir esta notificaciÃ³n.”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Khjýubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjúubjã)”}”(hŒÙSin embargo, operaciones que no mapean a operaciones similares a :manpage:`read(2)`/:manpage:`write(2)` tienen que ser implementadas como solicitudes :manpage:`ioctl(2)`, las cuales pueden llevar a un API algo opaca. ”h]”h¨)”}”(hŒØSin embargo, operaciones que no mapean a operaciones similares a :manpage:`read(2)`/:manpage:`write(2)` tienen que ser implementadas como solicitudes :manpage:`ioctl(2)`, las cuales pueden llevar a un API algo opaca.”h]”(hŒASin embargo, operaciones que no mapean a operaciones similares a ”…””}”(hjQhžhhŸNh NubhŒmanpage”“”)”}”(hŒ:manpage:`read(2)`”h]”hŒread(2)”…””}”(hj[hžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”Œ xml:space”Œpreserve”Œpath”Œread(2)”Œpage”Œread”Œsection”Œ2”uh1jYhjQubhŒ/”…””}”(hjQhžhhŸNh NubjZ)”}”(hŒ:manpage:`write(2)`”h]”hŒwrite(2)”…””}”(hjuhžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒwrite(2)”jmŒwrite”jojpuh1jYhjQubhŒ/ tienen que ser implementadas como solicitudes ”…””}”(hjQhžhhŸNh NubjZ)”}”(hŒ:manpage:`ioctl(2)`”h]”hŒioctl(2)”…””}”(hj‰hžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒioctl(2)”jmŒioctl”jojpuh1jYhjQubhŒ/, las cuales pueden llevar a un API algo opaca.”…””}”(hjQhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh K$hjMubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjúubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jÝhŸhØh Khjöubah}”(h]”h ]”h"]”h$]”h&]”uh1j×hŸhØh Khjäubeh}”(h]”h ]”h"]”h$]”h&]”uh1jâhjßubjã)”}”(hXáSi sÃ³lo estÃ¡ exponiendo informaciÃ³n del runtime, un nuevo nodo en sysfs (mire ``Documentation/filesystems/sysfs.rst``) o el filesystem ``/proc`` podrÃa ser mÃ¡s adecuado. Sin embargo, acceder a estos mecanismos requiere que el filesystem relevante estÃ© montado, lo que podrÃa no ser siempre el caso (e.g. en un ambiente namespaced/sandboxed/chrooted). Evite agregar cualquier API a debugfs, ya que no se considera una interfaz (interface) de 'producciÃ³n' para el userspace. ”h]”h¨)”}”(hXàSi sÃ³lo estÃ¡ exponiendo informaciÃ³n del runtime, un nuevo nodo en sysfs (mire ``Documentation/filesystems/sysfs.rst``) o el filesystem ``/proc`` podrÃa ser mÃ¡s adecuado. Sin embargo, acceder a estos mecanismos requiere que el filesystem relevante estÃ© montado, lo que podrÃa no ser siempre el caso (e.g. en un ambiente namespaced/sandboxed/chrooted). Evite agregar cualquier API a debugfs, ya que no se considera una interfaz (interface) de 'producciÃ³n' para el userspace.”h]”(hŒQSi sÃ³lo estÃ¡ exponiendo informaciÃ³n del runtime, un nuevo nodo en sysfs (mire ”…””}”(hjÁhžhhŸNh Nubj )”}”(hŒ'``Documentation/filesystems/sysfs.rst``”h]”hŒ#Documentation/filesystems/sysfs.rst”…””}”(hjÉhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÁubhŒ) o el filesystem ”…””}”(hjÁhžhhŸNh Nubj )”}”(hŒ ``/proc``”h]”hŒ/proc”…””}”(hjÛhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÁubhXQ podrÃa ser mÃ¡s adecuado. Sin embargo, acceder a estos mecanismos requiere que el filesystem relevante estÃ© montado, lo que podrÃa no ser siempre el caso (e.g. en un ambiente namespaced/sandboxed/chrooted). Evite agregar cualquier API a debugfs, ya que no se considera una interfaz (interface) de â€˜producciÃ³nâ€™ para el userspace.”…””}”(hjÁhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh K)hj½ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjßubjã)”}”(hXSi la operaciÃ³n es especÃfica a un archivo o descriptor de archivo especÃfico, entonces la opciÃ³n de comando adicional :manpage:`fcntl(2)` podrÃa ser mÃ¡s apropiada. Sin embargo, :manpage:`fcntl(2)` es una llamada al sistema multiplexada que esconde mucha complejidad, asÃ que esta opciÃ³n es mejor cuando la nueva funcion es analogamente cercana a la funcionalidad existente :manpage:`fcntl(2)`, o la nueva funcionalidad es muy simple (por ejemplo, definir/obtener un flag simple relacionado a un descriptor de archivo). ”h]”h¨)”}”(hXSi la operaciÃ³n es especÃfica a un archivo o descriptor de archivo especÃfico, entonces la opciÃ³n de comando adicional :manpage:`fcntl(2)` podrÃa ser mÃ¡s apropiada. Sin embargo, :manpage:`fcntl(2)` es una llamada al sistema multiplexada que esconde mucha complejidad, asÃ que esta opciÃ³n es mejor cuando la nueva funcion es analogamente cercana a la funcionalidad existente :manpage:`fcntl(2)`, o la nueva funcionalidad es muy simple (por ejemplo, definir/obtener un flag simple relacionado a un descriptor de archivo).”h]”(hŒ{Si la operaciÃ³n es especÃfica a un archivo o descriptor de archivo especÃfico, entonces la opciÃ³n de comando adicional ”…””}”(hjýhžhhŸNh NubjZ)”}”(hŒ:manpage:`fcntl(2)`”h]”hŒfcntl(2)”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒfcntl(2)”jmŒfcntl”jojpuh1jYhjýubhŒ* podrÃa ser mÃ¡s apropiada. Sin embargo, ”…””}”(hjýhžhhŸNh NubjZ)”}”(hŒ:manpage:`fcntl(2)`”h]”hŒfcntl(2)”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒfcntl(2)”jmŒfcntl”jojpuh1jYhjýubhŒ³ es una llamada al sistema multiplexada que esconde mucha complejidad, asÃ que esta opciÃ³n es mejor cuando la nueva funcion es analogamente cercana a la funcionalidad existente ”…””}”(hjýhžhhŸNh NubjZ)”}”(hŒ:manpage:`fcntl(2)`”h]”hŒfcntl(2)”…””}”(hj-hžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒfcntl(2)”jmŒfcntl”jojpuh1jYhjýubhŒ~, o la nueva funcionalidad es muy simple (por ejemplo, definir/obtener un flag simple relacionado a un descriptor de archivo).”…””}”(hjýhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh K1hjùubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjßubjã)”}”(hXySi la operaciÃ³n es especÃfica a un proceso o tarea particular, entonces un comando adicional :manpage:`prctl(2)` podrÃa ser mÃ¡s apropiado. Tal como con :manpage:`fcntl(2)`, esta llamada al sistema es un multiplexor complicado asÃ que estÃ¡ reservado para comandos anÃ¡logamente cercanos del existente ``prctl()`` u obtener/definir un flag simple relacionado a un proceso. ”h]”h¨)”}”(hXxSi la operaciÃ³n es especÃfica a un proceso o tarea particular, entonces un comando adicional :manpage:`prctl(2)` podrÃa ser mÃ¡s apropiado. Tal como con :manpage:`fcntl(2)`, esta llamada al sistema es un multiplexor complicado asÃ que estÃ¡ reservado para comandos anÃ¡logamente cercanos del existente ``prctl()`` u obtener/definir un flag simple relacionado a un proceso.”h]”(hŒ_Si la operaciÃ³n es especÃfica a un proceso o tarea particular, entonces un comando adicional ”…””}”(hjQhžhhŸNh NubjZ)”}”(hŒ:manpage:`prctl(2)`”h]”hŒprctl(2)”…””}”(hjYhžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒprctl(2)”jmŒprctl”jojpuh1jYhjQubhŒ* podrÃa ser mÃ¡s apropiado. Tal como con ”…””}”(hjQhžhhŸNh NubjZ)”}”(hŒ:manpage:`fcntl(2)`”h]”hŒfcntl(2)”…””}”(hjmhžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒfcntl(2)”jmŒfcntl”jojpuh1jYhjQubhŒƒ, esta llamada al sistema es un multiplexor complicado asÃ que estÃ¡ reservado para comandos anÃ¡logamente cercanos del existente ”…””}”(hjQhžhhŸNh Nubj )”}”(hŒ``prctl()``”h]”hŒprctl()”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjQubhŒ; u obtener/definir un flag simple relacionado a un proceso.”…””}”(hjQhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh K:hjMubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjßubeh}”(h]”h ]”h"]”h$]”h&]”j¯j°uh1jÝhŸhØh KhjÙubah}”(h]”h ]”h"]”h$]”h&]”uh1j×hŸhØh Khj¸hžhubeh}”(h]”Œ#alternativas-a-llamadas-del-sistema”ah ]”h"]”Œ#alternativas a llamadas del sistema”ah$]”h&]”uh1jqhjshžhhŸhØh Kubjr)”}”(hhh]”(jw)”}”(hŒ-DiseÃ±ando el API: Planeando para extensiones”h]”hŒ-DiseÃ±ando el API: Planeando para extensiones”…””}”(hj¶hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhj³hžhhŸhØh KBubh¨)”}”(hXUna nueva llamada del sistema forma parte del API del kernel, y tiene que ser soportada indefinidamente. Como tal, es una muy buena idea discutir explÃcitamente el interface en las listas de correo del kernel, y es importante planear para futuras extensiones del interface.”h]”hXUna nueva llamada del sistema forma parte del API del kernel, y tiene que ser soportada indefinidamente. Como tal, es una muy buena idea discutir explÃcitamente el interface en las listas de correo del kernel, y es importante planear para futuras extensiones del interface.”…””}”(hjÄhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh KDhj³hžhubh¨)”}”(hXg(La tabla syscall estÃ¡ poblada con ejemplos histÃ³ricos donde esto no se hizo, junto con los correspondientes seguimientos de los system calls -- ``eventfd``/``eventfd2``, ``dup2``/``dup3``, ``inotify_init``/``inotify_init1``, ``pipe``/``pipe2``, ``renameat``/``renameat2`` -- asÃ que aprenda de la historia del kernel y planee extensiones desde el inicio.)”h]”(hŒ“(La tabla syscall estÃ¡ poblada con ejemplos histÃ³ricos donde esto no se hizo, junto con los correspondientes seguimientos de los system calls -- ”…””}”(hjÒhžhhŸNh Nubj )”}”(hŒ``eventfd``”h]”hŒeventfd”…””}”(hjÚhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÒubhŒ/”…””}”(hjÒhžhhŸNh Nubj )”}”(hŒ``eventfd2``”h]”hŒeventfd2”…””}”(hjìhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÒubhŒ, ”…””}”(hjÒhžhhŸNh Nubj )”}”(hŒ``dup2``”h]”hŒdup2”…””}”(hjþhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÒubhŒ/”…””}”hjÒsbj )”}”(hŒ``dup3``”h]”hŒdup3”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÒubhŒ, ”…””}”hjÒsbj )”}”(hŒ``inotify_init``”h]”hŒinotify_init”…””}”(hj"hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÒubhŒ/”…””}”hjÒsbj )”}”(hŒ``inotify_init1``”h]”hŒ inotify_init1”…””}”(hj4hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÒubhŒ, ”…””}”(hjÒhžhhŸNh Nubj )”}”(hŒ``pipe``”h]”hŒpipe”…””}”(hjFhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÒubhŒ/”…””}”hjÒsbj )”}”(hŒ ``pipe2``”h]”hŒpipe2”…””}”(hjXhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÒubhŒ, ”…””}”hjÒsbj )”}”(hŒ``renameat``”h]”hŒrenameat”…””}”(hjjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÒubhŒ/”…””}”hjÒsbj )”}”(hŒ ``renameat2``”h]”hŒ renameat2”…””}”(hj|hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÒubhŒU -- asÃ que aprenda de la historia del kernel y planee extensiones desde el inicio.)”…””}”(hjÒhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh KIhj³hžhubh¨)”}”(hXPara llamadas al sistema mÃ¡s simples que sÃ³lo toman un par de argumentos, la forma preferida de permitir futuras extensiones es incluir un argumento flag a la llamada al sistema. Para asegurarse que el userspace pueda usar de forma segura estos flags entre versiones del kernel, revise si los flags contienen cualquier flag desconocido, y rechace la llamada al sistema (con ``EINVAL``) si ocurre::”h]”(hXxPara llamadas al sistema mÃ¡s simples que sÃ³lo toman un par de argumentos, la forma preferida de permitir futuras extensiones es incluir un argumento flag a la llamada al sistema. Para asegurarse que el userspace pueda usar de forma segura estos flags entre versiones del kernel, revise si los flags contienen cualquier flag desconocido, y rechace la llamada al sistema (con ”…””}”(hj”hžhhŸNh Nubj )”}”(hŒ ``EINVAL``”h]”hŒEINVAL”…””}”(hjœhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj”ubhŒ) si ocurre:”…””}”(hj”hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh KOhj³hžhubhŒ literal_block”“”)”}”(hŒJif (flags & ~(THING_FLAG1 | THINGFLAG2 | THING_FLAG3)) return -EINVAL;”h]”hŒJif (flags & ~(THING_FLAG1 | THINGFLAG2 | THING_FLAG3)) return -EINVAL;”…””}”hj¶sbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh KVhj³hžhubh¨)”}”(hŒW(Si no hay valores de flags usados aÃºn, revise que los argumentos del flag sean cero.)”h]”hŒW(Si no hay valores de flags usados aÃºn, revise que los argumentos del flag sean cero.)”…””}”(hjÄhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh KYhj³hžhubh¨)”}”(hXFPara llamadas al sistema mÃ¡s sofisticadas que involucran un gran nÃºmero de argumentos, es preferible encapsular la mayorÃa de los argumentos en una estructura que sea pasada a travÃ©s de un puntero. Tal estructura puede hacer frente a futuras extensiones mediante la inclusiÃ³n de un argumento de tamaÃ±o en la estructura::”h]”hXEPara llamadas al sistema mÃ¡s sofisticadas que involucran un gran nÃºmero de argumentos, es preferible encapsular la mayorÃa de los argumentos en una estructura que sea pasada a travÃ©s de un puntero. Tal estructura puede hacer frente a futuras extensiones mediante la inclusiÃ³n de un argumento de tamaÃ±o en la estructura:”…””}”(hjÒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh K\hj³hžhubjµ)”}”(hŒ–struct xyzzy_params { u32 size; /* userspace define p->size = sizeof(struct xyzzy_params) */ u32 param_1; u64 param_2; u64 param_3; };”h]”hŒ–struct xyzzy_params { u32 size; /* userspace define p->size = sizeof(struct xyzzy_params) */ u32 param_1; u64 param_2; u64 param_3; };”…””}”hjàsbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh Kbhj³hžhubh¨)”}”(hŒÕSiempre que cualquier campo aÃ±adido subsecuente, digamos ``param_4``, sea diseÃ±ado de forma tal que un valor cero, devuelva el comportamiento previo, entonces permite versiones no coincidentes en ambos sentidos:”h]”(hŒ:Siempre que cualquier campo aÃ±adido subsecuente, digamos ”…””}”(hjîhžhhŸNh Nubj )”}”(hŒ``param_4``”h]”hŒparam_4”…””}”(hjöhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjîubhŒ, sea diseÃ±ado de forma tal que un valor cero, devuelva el comportamiento previo, entonces permite versiones no coincidentes en ambos sentidos:”…””}”(hjîhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Kihj³hžhubjØ)”}”(hXý- Para hacer frente a programas del userspace mÃ¡s modernos, haciendo llamadas a un kernel mÃ¡s antiguo, el cÃ³digo del kernel debe revisar que cualquier memoria mÃ¡s allÃ¡ del tamaÃ±o de la estructura sea cero (revisar de manera efectiva que ``param_4 == 0``). - Para hacer frente a programas antiguos del userspace haciendo llamadas a un kernel mÃ¡s nuevo, el cÃ³digo del kernel puede extender con ceros, una instancia mÃ¡s pequeÃ±a de la estructura (definiendo efectivamente ``param_4 == 0``). ”h]”jÞ)”}”(hhh]”(jã)”}”(hXPara hacer frente a programas del userspace mÃ¡s modernos, haciendo llamadas a un kernel mÃ¡s antiguo, el cÃ³digo del kernel debe revisar que cualquier memoria mÃ¡s allÃ¡ del tamaÃ±o de la estructura sea cero (revisar de manera efectiva que ``param_4 == 0``).”h]”h¨)”}”(hXPara hacer frente a programas del userspace mÃ¡s modernos, haciendo llamadas a un kernel mÃ¡s antiguo, el cÃ³digo del kernel debe revisar que cualquier memoria mÃ¡s allÃ¡ del tamaÃ±o de la estructura sea cero (revisar de manera efectiva que ``param_4 == 0``).”h]”(hŒñPara hacer frente a programas del userspace mÃ¡s modernos, haciendo llamadas a un kernel mÃ¡s antiguo, el cÃ³digo del kernel debe revisar que cualquier memoria mÃ¡s allÃ¡ del tamaÃ±o de la estructura sea cero (revisar de manera efectiva que ”…””}”(hjhžhhŸNh Nubj )”}”(hŒ``param_4 == 0``”h]”hŒparam_4 == 0”…””}”(hj!hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒ).”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Kmhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjubjã)”}”(hŒéPara hacer frente a programas antiguos del userspace haciendo llamadas a un kernel mÃ¡s nuevo, el cÃ³digo del kernel puede extender con ceros, una instancia mÃ¡s pequeÃ±a de la estructura (definiendo efectivamente ``param_4 == 0``). ”h]”h¨)”}”(hŒèPara hacer frente a programas antiguos del userspace haciendo llamadas a un kernel mÃ¡s nuevo, el cÃ³digo del kernel puede extender con ceros, una instancia mÃ¡s pequeÃ±a de la estructura (definiendo efectivamente ``param_4 == 0``).”h]”(hŒÖPara hacer frente a programas antiguos del userspace haciendo llamadas a un kernel mÃ¡s nuevo, el cÃ³digo del kernel puede extender con ceros, una instancia mÃ¡s pequeÃ±a de la estructura (definiendo efectivamente ”…””}”(hjChžhhŸNh Nubj )”}”(hŒ``param_4 == 0``”h]”hŒparam_4 == 0”…””}”(hjKhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjCubhŒ).”…””}”(hjChžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Kqhj?ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjubeh}”(h]”h ]”h"]”h$]”h&]”j¯j°uh1jÝhŸhØh Kmhjubah}”(h]”h ]”h"]”h$]”h&]”uh1j×hŸhØh Kmhj³hžhubh¨)”}”(hŒŒRevise :manpage:`perf_event_open(2)` y la funciÃ³n ``perf_copy_attr()`` (en ``kernel/events/code.c``) para un ejemplo de esta aproximaciÃ³n.”h]”(hŒRevise ”…””}”(hjuhžhhŸNh NubjZ)”}”(hŒ:manpage:`perf_event_open(2)`”h]”hŒperf_event_open(2)”…””}”(hj}hžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒperf_event_open(2)”jmŒperf_event_open”jojpuh1jYhjuubhŒ y la funciÃ³n ”…””}”(hjuhžhhŸNh Nubj )”}”(hŒ``perf_copy_attr()``”h]”hŒperf_copy_attr()”…””}”(hj‘hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjuubhŒ (en ”…””}”(hjuhžhhŸNh Nubj )”}”(hŒ``kernel/events/code.c``”h]”hŒkernel/events/code.c”…””}”(hj£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjuubhŒ() para un ejemplo de esta aproximaciÃ³n.”…””}”(hjuhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Kvhj³hžhubeh}”(h]”Œ+disenando-el-api-planeando-para-extensiones”ah ]”h"]”Œ-diseÃ±ando el api: planeando para extensiones”ah$]”h&]”uh1jqhjshžhhŸhØh KBubjr)”}”(hhh]”(jw)”}”(hŒ(DiseÃ±ando el API: Otras consideraciones”h]”hŒ(DiseÃ±ando el API: Otras consideraciones”…””}”(hjÆhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhjÃhžhhŸhØh K{ubh¨)”}”(hXPSi su nueva llamada al sistema permite al userspace hacer referencia a un objeto del kernel, esta deberÃa usar un descriptor de archivo como el manipulador de ese objeto -- no invente un nuevo tipo de objeto manipulador userspace cuando el kernel ya tiene mecanismos y semÃ¡nticas bien definidas para usar los descriptores de archivos.”h]”hXPSi su nueva llamada al sistema permite al userspace hacer referencia a un objeto del kernel, esta deberÃa usar un descriptor de archivo como el manipulador de ese objeto -- no invente un nuevo tipo de objeto manipulador userspace cuando el kernel ya tiene mecanismos y semÃ¡nticas bien definidas para usar los descriptores de archivos.”…””}”(hjÔhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh K}hjÃhžhubh¨)”}”(hX‹Si su nueva llamada a sistema :manpage:`xyzzy(2)` retorna un nuevo descriptor de archivo, entonces el argumento flag debe incluir un valor que sea equivalente a definir ``O_CLOEXEC`` en el nuevo FD. Esto hace posible al userspace acortar la brecha de tiempo entre ``xyzzy()`` y la llamada a ``fcntl(fd, F_SETFD, FD_CLOEXEC)``, donde un ``fork()`` inesperado y ``execve()`` en otro hilo podrÃan filtrar un descriptor al programa ejecutado. (Sin embargo, resista la tentaciÃ³n de reusar el valor actual de la constante ``O_CLOEXEC``, ya que es especÃfica de la arquitectura y es parte de un espacio numerado de flags ``O_*`` que estÃ¡ bastante lleno.)”h]”(hŒSi su nueva llamada a sistema ”…””}”(hjâhžhhŸNh NubjZ)”}”(hŒ:manpage:`xyzzy(2)`”h]”hŒxyzzy(2)”…””}”(hjêhžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒxyzzy(2)”jmŒxyzzy”jojpuh1jYhjâubhŒx retorna un nuevo descriptor de archivo, entonces el argumento flag debe incluir un valor que sea equivalente a definir ”…””}”(hjâhžhhŸNh Nubj )”}”(hŒ ``O_CLOEXEC``”h]”hŒ O_CLOEXEC”…””}”(hjþhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjâubhŒR en el nuevo FD. Esto hace posible al userspace acortar la brecha de tiempo entre ”…””}”(hjâhžhhŸNh Nubj )”}”(hŒ``xyzzy()``”h]”hŒxyzzy()”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjâubhŒ y la llamada a ”…””}”(hjâhžhhŸNh Nubj )”}”(hŒ"``fcntl(fd, F_SETFD, FD_CLOEXEC)``”h]”hŒfcntl(fd, F_SETFD, FD_CLOEXEC)”…””}”(hj"hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjâubhŒ, donde un ”…””}”(hjâhžhhŸNh Nubj )”}”(hŒ ``fork()``”h]”hŒfork()”…””}”(hj4hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjâubhŒ inesperado y ”…””}”(hjâhžhhŸNh Nubj )”}”(hŒ``execve()``”h]”hŒexecve()”…””}”(hjFhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjâubhŒ’ en otro hilo podrÃan filtrar un descriptor al programa ejecutado. (Sin embargo, resista la tentaciÃ³n de reusar el valor actual de la constante ”…””}”(hjâhžhhŸNh Nubj )”}”(hŒ ``O_CLOEXEC``”h]”hŒ O_CLOEXEC”…””}”(hjXhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjâubhŒV, ya que es especÃfica de la arquitectura y es parte de un espacio numerado de flags ”…””}”(hjâhžhhŸNh Nubj )”}”(hŒ``O_*``”h]”hŒO_*”…””}”(hjjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjâubhŒ que estÃ¡ bastante lleno.)”…””}”(hjâhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh KƒhjÃhžhubh¨)”}”(hX„Si su llamada de sistema retorna un nuevo descriptor de archivo, deberÃa considerar tambiÃ©n que significa usar la familia de llamadas de sistema :manpage:`poll(2)` en ese descriptor de archivo. Hacer un descriptor de archivo listo para leer o escribir es la forma normal para que el kernel indique al espacio de usuario que un evento ha ocurrido en el correspondiente objeto del kernel.”h]”(hŒ“Si su llamada de sistema retorna un nuevo descriptor de archivo, deberÃa considerar tambiÃ©n que significa usar la familia de llamadas de sistema ”…””}”(hj‚hžhhŸNh NubjZ)”}”(hŒ:manpage:`poll(2)`”h]”hŒpoll(2)”…””}”(hjŠhžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒpoll(2)”jmŒpoll”jojpuh1jYhj‚ubhŒß en ese descriptor de archivo. Hacer un descriptor de archivo listo para leer o escribir es la forma normal para que el kernel indique al espacio de usuario que un evento ha ocurrido en el correspondiente objeto del kernel.”…””}”(hj‚hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh KhjÃhžhubh¨)”}”(hŒfSi su nueva llamada de sistema :manpage:`xyzzy(2)` involucra algÃºn nombre de archivo como argumento::”h]”(hŒSi su nueva llamada de sistema ”…””}”(hj¤hžhhŸNh NubjZ)”}”(hŒ:manpage:`xyzzy(2)`”h]”hŒxyzzy(2)”…””}”(hj¬hžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒxyzzy(2)”jmŒxyzzy”jojpuh1jYhj¤ubhŒ3 involucra algÃºn nombre de archivo como argumento:”…””}”(hj¤hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh K”hjÃhžhubjµ)”}”(hŒ@int sys_xyzzy(const char __user *path, ..., unsigned int flags);”h]”hŒ@int sys_xyzzy(const char __user *path, ..., unsigned int flags);”…””}”hjÆsbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh K—hjÃhžhubh¨)”}”(hŒUdeberÃa considerar tambiÃ©n si una versiÃ³n :manpage:`xyzzyat(2)` es mas apropiada::”h]”(hŒ-deberÃa considerar tambiÃ©n si una versiÃ³n ”…””}”(hjÔhžhhŸNh NubjZ)”}”(hŒ:manpage:`xyzzyat(2)`”h]”hŒ xyzzyat(2)”…””}”(hjÜhžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒ xyzzyat(2)”jmŒxyzzyat”jojpuh1jYhjÔubhŒ es mas apropiada:”…””}”(hjÔhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh K™hjÃhžhubjµ)”}”(hŒKint sys_xyzzyat(int dfd, const char __user *path, ..., unsigned int flags);”h]”hŒKint sys_xyzzyat(int dfd, const char __user *path, ..., unsigned int flags);”…””}”hjösbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh KœhjÃhžhubh¨)”}”(hXEsto permite mÃ¡s flexibilidad en como el userspace especifica el archivo en cuestiÃ³n; en particular esto permite al userspace pedir la funcionalidad a un descriptor de archivo ya abierto usando el flag ``AT_EMPTY_PATH``, efectivamente dando una operaciÃ³n :manpage:`fxyzzy(3)` gratis::”h]”(hŒÌEsto permite mÃ¡s flexibilidad en como el userspace especifica el archivo en cuestiÃ³n; en particular esto permite al userspace pedir la funcionalidad a un descriptor de archivo ya abierto usando el flag ”…””}”(hjhžhhŸNh Nubj )”}”(hŒ``AT_EMPTY_PATH``”h]”hŒ AT_EMPTY_PATH”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒ%, efectivamente dando una operaciÃ³n ”…””}”(hjhžhhŸNh NubjZ)”}”(hŒ:manpage:`fxyzzy(3)`”h]”hŒ fxyzzy(3)”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒ fxyzzy(3)”jmŒfxyzzy”joŒ3”uh1jYhjubhŒ gratis:”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh KžhjÃhžhubjµ)”}”(hŒŠ- xyzzyat(AT_FDCWD, path, ..., 0) es equivalente a xyzzy(path, ...) - xyzzyat(fd, "", ..., AT_EMPTY_PATH) es equivalente a fxyzzy(fd, ...)”h]”hŒŠ- xyzzyat(AT_FDCWD, path, ..., 0) es equivalente a xyzzy(path, ...) - xyzzyat(fd, "", ..., AT_EMPTY_PATH) es equivalente a fxyzzy(fd, ...)”…””}”hj9sbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh K£hjÃhžhubh¨)”}”(hŒÆ(Para mÃ¡s detalles sobre la explicaciÃ³n racional de las llamadas \*at(), revise el man page :manpage:`openat(2)`; para un ejemplo de AT_EMPTY_PATH, mire el man page :manpage:`fstatat(2)` manpage.)”h]”(hŒ^(Para mÃ¡s detalles sobre la explicaciÃ³n racional de las llamadas *at(), revise el man page ”…””}”(hjGhžhhŸNh NubjZ)”}”(hŒ:manpage:`openat(2)`”h]”hŒ openat(2)”…””}”(hjOhžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒ openat(2)”jmŒopenat”jojpuh1jYhjGubhŒ5; para un ejemplo de AT_EMPTY_PATH, mire el man page ”…””}”(hjGhžhhŸNh NubjZ)”}”(hŒ:manpage:`fstatat(2)`”h]”hŒ fstatat(2)”…””}”(hjchžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒ fstatat(2)”jmŒfstatat”jojpuh1jYhjGubhŒ manpage.)”…””}”(hjGhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh K¦hjÃhžhubh¨)”}”(hŒýSi su nueva llamada de sistema :manpage:`xyzzy(2)` involucra un parÃ¡metro describiendo un describiendo un movimiento dentro de un archivo, ponga de tipo ``loff_t`` para que movimientos de 64-bit puedan ser soportados incluso en arquitecturas de 32-bit.”h]”(hŒSi su nueva llamada de sistema ”…””}”(hj}hžhhŸNh NubjZ)”}”(hŒ:manpage:`xyzzy(2)`”h]”hŒxyzzy(2)”…””}”(hj…hžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒxyzzy(2)”jmŒxyzzy”jojpuh1jYhj}ubhŒh involucra un parÃ¡metro describiendo un describiendo un movimiento dentro de un archivo, ponga de tipo ”…””}”(hj}hžhhŸNh Nubj )”}”(hŒ ``loff_t``”h]”hŒloff_t”…””}”(hj™hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj}ubhŒY para que movimientos de 64-bit puedan ser soportados incluso en arquitecturas de 32-bit.”…””}”(hj}hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh KªhjÃhžhubh¨)”}”(hXSi su nueva llamada de sistema :manpage:`xyzzy` involucra una funcionalidad privilegiada, esta necesita ser gobernada por la capability bit linux apropiada (revisado con una llamada a ``capable()``), como se describe en el man page :manpage:`capabilities(7)`. Elija una parte de capability linux que govierne las funcionalidades relacionadas, pero trate de evitar combinar muchas funciones sÃ³lo relacionadas vagamente bajo la misma secciÃ³n, ya que va en contra de los propÃ³sitos de las capabilities de dividir el poder del usuario root. En particular, evite agregar nuevos usos de la capacidad ya demasiado general de la capabilities ``CAP_SYS_ADMIN``.”h]”(hŒ Si su nueva llamada de sistema ”…””}”(hj±hžhhŸNh NubjZ)”}”(hŒ:manpage:`xyzzy`”h]”hŒxyzzy”…””}”(hj¹hžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjŒpath”Œxyzzy”Œpage”jÈjqhuh1jYhj±ubhŒ‰ involucra una funcionalidad privilegiada, esta necesita ser gobernada por la capability bit linux apropiada (revisado con una llamada a ”…””}”(hj±hžhhŸNh Nubj )”}”(hŒ ``capable()``”h]”hŒ capable()”…””}”(hjÎhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj±ubhŒ#), como se describe en el man page ”…””}”(hj±hžhhŸNh NubjZ)”}”(hŒ:manpage:`capabilities(7)`”h]”hŒcapabilities(7)”…””}”(hjàhžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒcapabilities(7)”jmŒcapabilities”joŒ7”uh1jYhj±ubhX{. Elija una parte de capability linux que govierne las funcionalidades relacionadas, pero trate de evitar combinar muchas funciones sÃ³lo relacionadas vagamente bajo la misma secciÃ³n, ya que va en contra de los propÃ³sitos de las capabilities de dividir el poder del usuario root. En particular, evite agregar nuevos usos de la capacidad ya demasiado general de la capabilities ”…””}”(hj±hžhhŸNh Nubj )”}”(hŒ``CAP_SYS_ADMIN``”h]”hŒ CAP_SYS_ADMIN”…””}”(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žhubh¨)”}”(hXWSi su nueva llamada de sistema :manpage:`xyzzy(2)` manipula un proceso que no es el proceso invocado, este deberÃa ser restringido (usando una llamada a ``ptrace_may_access()``) de forma que el Ãºnico proceso con los mismos permisos del proceso objetivo, o con las capacidades (capabilities) necesarias, pueda manipulador el proceso objetivo.”h]”(hŒSi su nueva llamada de sistema ”…””}”(hj hžhhŸNh NubjZ)”}”(hŒ:manpage:`xyzzy(2)`”h]”hŒxyzzy(2)”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒxyzzy(2)”jmŒxyzzy”jojpuh1jYhj ubhŒh manipula un proceso que no es el proceso invocado, este deberÃa ser restringido (usando una llamada a ”…””}”(hj hžhhŸNh Nubj )”}”(hŒ``ptrace_may_access()``”h]”hŒptrace_may_access()”…””}”(hj)hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj ubhŒ¦) de forma que el Ãºnico proceso con los mismos permisos del proceso objetivo, o con las capacidades (capabilities) necesarias, pueda manipulador el proceso objetivo.”…””}”(hj hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh K¹hjÃhžhubh¨)”}”(hX|Finalmente, debe ser conciente de que algunas arquitecturas no-x86 tienen un manejo mÃ¡s sencillo si los parÃ¡metros que son explÃcitamente 64-bit caigan en argumentos enumerados impares (i.e. parÃ¡metros 1,3,5), para permitir el uso de pares contiguos de registros 32-bits. (Este cuidado no aplica si el argumento es parte de una estructura que se pasa a travÃ©s de un puntero.)”h]”hX|Finalmente, debe ser conciente de que algunas arquitecturas no-x86 tienen un manejo mÃ¡s sencillo si los parÃ¡metros que son explÃcitamente 64-bit caigan en argumentos enumerados impares (i.e. parÃ¡metros 1,3,5), para permitir el uso de pares contiguos de registros 32-bits. (Este cuidado no aplica si el argumento es parte de una estructura que se pasa a travÃ©s de un puntero.)”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh K¿hjÃhžhubeh}”(h]”Œ&disenando-el-api-otras-consideraciones”ah ]”h"]”Œ(diseÃ±ando el api: otras consideraciones”ah$]”h&]”uh1jqhjshžhhŸhØh K{ubjr)”}”(hhh]”(jw)”}”(hŒProponiendo el API”h]”hŒProponiendo el API”…””}”(hjZhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhjWhžhhŸhØh KÇubh¨)”}”(hXPara hacer una nueva llamada al sistema fÃ¡cil de revisar, es mejor dividir el patchset (conjunto de parches) en trozos separados. Estos deberÃan incluir al menos los siguientes items como commits distintos (cada uno de los cuales se describirÃ¡ mÃ¡s abajo):”h]”hXPara hacer una nueva llamada al sistema fÃ¡cil de revisar, es mejor dividir el patchset (conjunto de parches) en trozos separados. Estos deberÃan incluir al menos los siguientes items como commits distintos (cada uno de los cuales se describirÃ¡ mÃ¡s abajo):”…””}”(hjhhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh KÉhjWhžhubjØ)”}”(hXb- La implementaciÃ³n central de la llamada al sistema, junto con prototipos, numeraciÃ³n genÃ©rica, cambios Kconfig e implementaciones de rutinas de respaldo (fallback stub) - Conectar la nueva llamada a sistema a una arquitectura particular, usualmente x86 (incluyendo todas las x86_64, x86_32 y x32). - Una demostraciÃ³n del use de la nueva llamada a sistema en el userspace vÃa un selftest en ``tools/testing/selftest/``. - Un borrador de man-page para la nueva llamada a sistema, ya sea como texto plano en la carta de presentaciÃ³n, o como un parche (separado) para el repositorio man-pages. ”h]”jÞ)”}”(hhh]”(jã)”}”(hŒ«La implementaciÃ³n central de la llamada al sistema, junto con prototipos, numeraciÃ³n genÃ©rica, cambios Kconfig e implementaciones de rutinas de respaldo (fallback stub)”h]”h¨)”}”(hŒ«La implementaciÃ³n central de la llamada al sistema, junto con prototipos, numeraciÃ³n genÃ©rica, cambios Kconfig e implementaciones de rutinas de respaldo (fallback stub)”h]”hŒ«La implementaciÃ³n central de la llamada al sistema, junto con prototipos, numeraciÃ³n genÃ©rica, cambios Kconfig e implementaciones de rutinas de respaldo (fallback stub)”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh KÎhj}ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjzubjã)”}”(hŒ~Conectar la nueva llamada a sistema a una arquitectura particular, usualmente x86 (incluyendo todas las x86_64, x86_32 y x32).”h]”h¨)”}”(hŒ~Conectar la nueva llamada a sistema a una arquitectura particular, usualmente x86 (incluyendo todas las x86_64, x86_32 y x32).”h]”hŒ~Conectar la nueva llamada a sistema a una arquitectura particular, usualmente x86 (incluyendo todas las x86_64, x86_32 y x32).”…””}”(hj™hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh KÑhj•ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjzubjã)”}”(hŒxUna demostraciÃ³n del use de la nueva llamada a sistema en el userspace vÃa un selftest en ``tools/testing/selftest/``.”h]”h¨)”}”(hŒxUna demostraciÃ³n del use de la nueva llamada a sistema en el userspace vÃa un selftest en ``tools/testing/selftest/``.”h]”(hŒ\Una demostraciÃ³n del use de la nueva llamada a sistema en el userspace vÃa un selftest en ”…””}”(hj±hžhhŸNh Nubj )”}”(hŒ``tools/testing/selftest/``”h]”hŒtools/testing/selftest/”…””}”(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Óhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjzubjã)”}”(hŒªUn borrador de man-page para la nueva llamada a sistema, ya sea como texto plano en la carta de presentaciÃ³n, o como un parche (separado) para el repositorio man-pages. ”h]”h¨)”}”(hŒ©Un borrador de man-page para la nueva llamada a sistema, ya sea como texto plano en la carta de presentaciÃ³n, o como un parche (separado) para el repositorio man-pages.”h]”hŒ©Un borrador de man-page para la nueva llamada a sistema, ya sea como texto plano en la carta de presentaciÃ³n, o como un parche (separado) para el repositorio man-pages.”…””}”(hjÛhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh KÕhj×ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjzubeh}”(h]”h ]”h"]”h$]”h&]”j¯j°uh1jÝhŸhØh KÎhjvubah}”(h]”h ]”h"]”h$]”h&]”uh1j×hŸhØh KÎhjWhžhubh¨)”}”(hŒŒNuevas propuestas de llamadas de sistema, como cualquier cambio al API del kernel, deberÃa siempre ser copiado a linux-api@vger.kernel.org.”h]”(hŒrNuevas propuestas de llamadas de sistema, como cualquier cambio al API del kernel, deberÃa siempre ser copiado a ”…””}”(hjûhžhhŸNh Nubj6)”}”(hŒlinux-api@vger.kernel.org”h]”hŒlinux-api@vger.kernel.org”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ mailto:linux-api@vger.kernel.org”uh1j5hjûubhŒ.”…””}”(hjûhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh KÙhjWhžhubeh}”(h]”Œproponiendo-el-api”ah ]”h"]”Œproponiendo el api”ah$]”h&]”uh1jqhjshžhhŸhØh KÇubjr)”}”(hhh]”(jw)”}”(hŒ-Implementation de Llamada de Sistema Generica”h]”hŒ-Implementation de Llamada de Sistema Generica”…””}”(hj( hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhj% hžhhŸhØh KÞubh¨)”}”(hXùLa entrada principal a su nueva llamada de sistema :manpage:`xyzzy(2)` serÃ¡ llamada ``sys_xyzzy()``, pero incluya este punto de entrada con la macro ``SYSCALL_DEFINEn()`` apropiada en vez de explicitamente. El 'n' indica el numero de argumentos de la llamada de sistema, y la macro toma el nombre de la llamada de sistema seguida por el par (tipo, nombre) para los parÃ¡metros como argumentos. Usar esta macro permite a la metadata de la nueva llamada de sistema estar disponible para otras herramientas.”h]”(hŒ3La entrada principal a su nueva llamada de sistema ”…””}”(hj6 hžhhŸNh NubjZ)”}”(hŒ:manpage:`xyzzy(2)`”h]”hŒxyzzy(2)”…””}”(hj> hžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒxyzzy(2)”jmŒxyzzy”jojpuh1jYhj6 ubhŒ serÃ¡ llamada ”…””}”(hj6 hžhhŸNh Nubj )”}”(hŒ``sys_xyzzy()``”h]”hŒsys_xyzzy()”…””}”(hjR hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj6 ubhŒ2, pero incluya este punto de entrada con la macro ”…””}”(hj6 hžhhŸNh Nubj )”}”(hŒ``SYSCALL_DEFINEn()``”h]”hŒSYSCALL_DEFINEn()”…””}”(hjd hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj6 ubhXR apropiada en vez de explicitamente. El â€˜nâ€™ indica el numero de argumentos de la llamada de sistema, y la macro toma el nombre de la llamada de sistema seguida por el par (tipo, nombre) para los parÃ¡metros como argumentos. Usar esta macro permite a la metadata de la nueva llamada de sistema estar disponible para otras herramientas.”…””}”(hj6 hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Kàhj% hžhubh¨)”}”(hŒÖEl nuevo punto de entrada tambiÃ©n necesita un prototipo de funciÃ³n correspondiente en ``include/linux/syscalls.h``, marcado como asmlinkage para calzar en la manera en que las llamadas de sistema son invocadas::”h]”(hŒXEl nuevo punto de entrada tambiÃ©n necesita un prototipo de funciÃ³n correspondiente en ”…””}”(hj| hžhhŸNh Nubj )”}”(hŒ``include/linux/syscalls.h``”h]”hŒinclude/linux/syscalls.h”…””}”(hj„ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj| ubhŒa, marcado como asmlinkage para calzar en la manera en que las llamadas de sistema son invocadas:”…””}”(hj| hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Kèhj% hžhubjµ)”}”(hŒasmlinkage long sys_xyzzy(...);”h]”hŒasmlinkage long sys_xyzzy(...);”…””}”hjœ sbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh Kìhj% hžhubh¨)”}”(hX7Algunas arquitecturas (e.g. x86) tienen sus propias tablas de syscall especÃficas para la arquitectura, pero muchas otras arquitecturas comparten una tabla de syscall genÃ©ricas. Agrega su nueva llamada de sistema a la lista genÃ©rica agregando una entrada a la lista en ``include/uapi/asm-generic/unistd.h``::”h]”(hXAlgunas arquitecturas (e.g. x86) tienen sus propias tablas de syscall especÃficas para la arquitectura, pero muchas otras arquitecturas comparten una tabla de syscall genÃ©ricas. Agrega su nueva llamada de sistema a la lista genÃ©rica agregando una entrada a la lista en ”…””}”(hjª hžhhŸNh Nubj )”}”(hŒ%``include/uapi/asm-generic/unistd.h``”h]”hŒ!include/uapi/asm-generic/unistd.h”…””}”(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žhubjµ)”}”(hŒ8#define __NR_xyzzy 292 __SYSCALL(__NR_xyzzy, sys_xyzzy )”h]”hŒ8#define __NR_xyzzy 292 __SYSCALL(__NR_xyzzy, sys_xyzzy )”…””}”hjÊ sbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh Kôhj% hžhubh¨)”}”(hX TambiÃ©n actualice el conteo de __NR_syscalls para reflejar la llamada de sistema adicional, y note que si multiples llamadas de sistema nuevas son aÃ±adidas en la misma ventana unida, su nueva llamada de sistema podrÃa tener que ser ajustada para resolver conflictos.”h]”hX TambiÃ©n actualice el conteo de __NR_syscalls para reflejar la llamada de sistema adicional, y note que si multiples llamadas de sistema nuevas son aÃ±adidas en la misma ventana unida, su nueva llamada de sistema podrÃa tener que ser ajustada para resolver conflictos.”…””}”(hjØ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh K÷hj% hžhubh¨)”}”(hŒÆEl archivo ``kernel/sys_ni.c`` provee una implementaciÃ³n fallback stub (rutina de respaldo) para cada llamada de sistema, retornando ``-ENOSYS``. Incluya su nueva llamada a sistema aquÃ tambiÃ©n::”h]”(hŒEl archivo ”…””}”(hjæ hžhhŸNh Nubj )”}”(hŒ``kernel/sys_ni.c``”h]”hŒkernel/sys_ni.c”…””}”(hjî hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjæ ubhŒh provee una implementaciÃ³n fallback stub (rutina de respaldo) para cada llamada de sistema, retornando ”…””}”(hjæ hžhhŸNh Nubj )”}”(hŒ``-ENOSYS``”h]”hŒ-ENOSYS”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjæ ubhŒ4. Incluya su nueva llamada a sistema aquÃ tambiÃ©n:”…””}”(hjæ hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Kühj% hžhubjµ)”}”(hŒCOND_SYSCALL(xyzzy);”h]”hŒCOND_SYSCALL(xyzzy);”…””}”hj sbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh Mhj% hžhubh¨)”}”(hŒòSu nueva funcionalidad del kernel, y la llamada de sistema que la controla, deberÃa normalmente ser opcional, asÃ que incluya una opciÃ³n ``CONFIG`` (tipicamente en ``init/Kconfig``) para ella. Como es usual para opciones ``CONFIG`` nuevas:”h]”(hŒŒSu nueva funcionalidad del kernel, y la llamada de sistema que la controla, deberÃa normalmente ser opcional, asÃ que incluya una opciÃ³n ”…””}”(hj& hžhhŸNh Nubj )”}”(hŒ ``CONFIG``”h]”hŒCONFIG”…””}”(hj. hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj& ubhŒ (tipicamente en ”…””}”(hj& hžhhŸNh Nubj )”}”(hŒ``init/Kconfig``”h]”hŒinit/Kconfig”…””}”(hj@ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj& ubhŒ)) para ella. Como es usual para opciones ”…””}”(hj& hžhhŸNh Nubj )”}”(hŒ ``CONFIG``”h]”hŒCONFIG”…””}”(hjR hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj& ubhŒ nuevas:”…””}”(hj& hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mhj% hžhubjØ)”}”(hXÍ- Incluya una descripciÃ³n para la nueva funcionalidad y llamada al sistema controlada por la opciÃ³n. - Haga la opciÃ³n dependiendo de EXPERT si esta debe estar escondida de los usuarios normales. - Haga que cualquier nuevo archivo fuente que implemente la funciÃ³n dependa de la opciÃ³n CONFIG en el Makefile (e.g. ``obj-$(CONFIG_XYZZY_SYSCALL) += xyzzy.o``). - Revise dos veces que el kernel se siga compilando con la nueva opciÃ³n CONFIG apagada. ”h]”jÞ)”}”(hhh]”(jã)”}”(hŒdIncluya una descripciÃ³n para la nueva funcionalidad y llamada al sistema controlada por la opciÃ³n.”h]”h¨)”}”(hŒdIncluya una descripciÃ³n para la nueva funcionalidad y llamada al sistema controlada por la opciÃ³n.”h]”hŒdIncluya una descripciÃ³n para la nueva funcionalidad y llamada al sistema controlada por la opciÃ³n.”…””}”(hju hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mhjq ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjn ubjã)”}”(hŒ\Haga la opciÃ³n dependiendo de EXPERT si esta debe estar escondida de los usuarios normales.”h]”h¨)”}”(hŒ\Haga la opciÃ³n dependiendo de EXPERT si esta debe estar escondida de los usuarios normales.”h]”hŒ\Haga la opciÃ³n dependiendo de EXPERT si esta debe estar escondida de los usuarios normales.”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M hj‰ ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjn ubjã)”}”(hŒ¡Haga que cualquier nuevo archivo fuente que implemente la funciÃ³n dependa de la opciÃ³n CONFIG en el Makefile (e.g. ``obj-$(CONFIG_XYZZY_SYSCALL) += xyzzy.o``).”h]”h¨)”}”(hŒ¡Haga que cualquier nuevo archivo fuente que implemente la funciÃ³n dependa de la opciÃ³n CONFIG en el Makefile (e.g. ``obj-$(CONFIG_XYZZY_SYSCALL) += xyzzy.o``).”h]”(hŒuHaga que cualquier nuevo archivo fuente que implemente la funciÃ³n dependa de la opciÃ³n CONFIG en el Makefile (e.g. ”…””}”(hj¥ hžhhŸNh Nubj )”}”(hŒ*``obj-$(CONFIG_XYZZY_SYSCALL) += xyzzy.o``”h]”hŒ&obj-$(CONFIG_XYZZY_SYSCALL) += xyzzy.o”…””}”(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 Mhj¡ ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjn ubjã)”}”(hŒWRevise dos veces que el kernel se siga compilando con la nueva opciÃ³n CONFIG apagada. ”h]”h¨)”}”(hŒVRevise dos veces que el kernel se siga compilando con la nueva opciÃ³n CONFIG apagada.”h]”hŒVRevise dos veces que el kernel se siga compilando con la nueva opciÃ³n CONFIG apagada.”…””}”(hjÏ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MhjË ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjn ubeh}”(h]”h ]”h"]”h$]”h&]”j¯j°uh1jÝhŸhØh Mhjj ubah}”(h]”h ]”h"]”h$]”h&]”uh1j×hŸhØh Mhj% hžhubh¨)”}”(hŒ-Para resumir, necesita un commit que incluya:”h]”hŒ-Para resumir, necesita un commit que incluya:”…””}”(hjï hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mhj% hžhubjØ)”}”(hX4- una opciÃ³n ``CONFIG`` para la nueva funciÃ³n, normalmente en ``init/Kconfig`` - ``SYSCALL_DEFINEn(xyzzy, ...)`` para el punto de entrada - El correspondiente prototipo en ``include/linux/syscalls.h`` - Una entrada genÃ©rica en ``include/uapi/asm-generic/unistd.h`` - fallback stub en ``kernel/sys_ni.c`` ”h]”jÞ)”}”(hhh]”(jã)”}”(hŒNuna opciÃ³n ``CONFIG`` para la nueva funciÃ³n, normalmente en ``init/Kconfig``”h]”h¨)”}”(hjh]”(hŒuna opciÃ³n ”…””}”(hjhžhhŸNh Nubj )”}”(hŒ ``CONFIG``”h]”hŒCONFIG”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒ( para la nueva funciÃ³n, normalmente en ”…””}”(hjhžhhŸNh Nubj )”}”(hŒ``init/Kconfig``”h]”hŒinit/Kconfig”…””}”(hj!hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjubjã)”}”(hŒ8``SYSCALL_DEFINEn(xyzzy, ...)`` para el punto de entrada”h]”h¨)”}”(hj=h]”(j )”}”(hŒ``SYSCALL_DEFINEn(xyzzy, ...)``”h]”hŒSYSCALL_DEFINEn(xyzzy, ...)”…””}”(hjBhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj?ubhŒ para el punto de entrada”…””}”(hj?hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mhj;ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjubjã)”}”(hŒUna entrada genÃ©rica en ``include/uapi/asm-generic/unistd.h``”h]”h¨)”}”(hj‡h]”(hŒUna entrada genÃ©rica en ”…””}”(hj‰hžhhŸNh Nubj )”}”(hŒ%``include/uapi/asm-generic/unistd.h``”h]”hŒ!include/uapi/asm-generic/unistd.h”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj‰ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mhj…ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjubjã)”}”(hŒ&fallback stub en ``kernel/sys_ni.c`` ”h]”h¨)”}”(hŒ$fallback stub en ``kernel/sys_ni.c``”h]”(hŒfallback stub en ”…””}”(hj®hžhhŸNh Nubj )”}”(hŒ``kernel/sys_ni.c``”h]”hŒkernel/sys_ni.c”…””}”(hj¶hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj®ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mhjªubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjubeh}”(h]”h ]”h"]”h$]”h&]”j¯j°uh1jÝhŸhØh Mhjý ubah}”(h]”h ]”h"]”h$]”h&]”uh1j×hŸhØh Mhj% hžhubeh}”(h]”Œ-implementation-de-llamada-de-sistema-generica”ah ]”h"]”Œ-implementation de llamada de sistema generica”ah$]”h&]”uh1jqhjshžhhŸhØh KÞubjr)”}”(hhh]”(jw)”}”(hŒ)ImplementaciÃ³n de Llamada de Sistema x86”h]”hŒ)ImplementaciÃ³n de Llamada de Sistema x86”…””}”(hjçhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhjähžhhŸhØh Mubh¨)”}”(hX.Para conectar su nueva llamada de sistema a plataformas x86, necesita actualizar las tablas maestras syscall. Asumiendo que su nueva llamada de sistema ni es especial de alguna manera (revise abajo), esto involucra una entrada "comÃºn" (para x86_64 y x86_32) en arch/x86/entry/syscalls/syscall_64.tbl::”h]”hX1Para conectar su nueva llamada de sistema a plataformas x86, necesita actualizar las tablas maestras syscall. Asumiendo que su nueva llamada de sistema ni es especial de alguna manera (revise abajo), esto involucra una entrada â€œcomÃºnâ€ (para x86_64 y x86_32) en arch/x86/entry/syscalls/syscall_64.tbl:”…””}”(hjõhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mhjähžhubjµ)”}”(hŒ!333 common xyzz sys_xyzzy”h]”hŒ!333 common xyzz sys_xyzzy”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh M#hjähžhubh¨)”}”(hŒDy una entrada "i386" en ``arch/x86/entry/syscalls/syscall_32.tbl``::”h]”(hŒy una entrada â€œi386â€ en ”…””}”(hjhžhhŸNh Nubj )”}”(hŒ*``arch/x86/entry/syscalls/syscall_32.tbl``”h]”hŒ&arch/x86/entry/syscalls/syscall_32.tbl”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒ:”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M%hjähžhubjµ)”}”(hŒ!380 i386 xyzz sys_xyzzy”h]”hŒ!380 i386 xyzz sys_xyzzy”…””}”hj1sbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh M'hjähžhubh¨)”}”(hŒqDe nuevo, estos nÃºmero son propensos de ser cambiados si hay conflictos en la ventana de integraciÃ³n relevante.”h]”hŒqDe nuevo, estos nÃºmero son propensos de ser cambiados si hay conflictos en la ventana de integraciÃ³n relevante.”…””}”(hj?hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M)hjähžhubeh}”(h]”Œ(implementacion-de-llamada-de-sistema-x86”ah ]”h"]”Œ)implementaciÃ³n de llamada de sistema x86”ah$]”h&]”uh1jqhjshžhhŸhØh Mubjr)”}”(hhh]”(jw)”}”(hŒ1Compatibilidad de Llamadas de Sistema (GenÃ©rica)”h]”hŒ1Compatibilidad de Llamadas de Sistema (GenÃ©rica)”…””}”(hjXhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhjUhžhhŸhØh M.ubh¨)”}”(hXPara la mayorÃa de llamadas al sistema la misma implementaciÃ³n 64-bit puede ser invocada incluso cuando el programa de userspace es en si mismo 32-bit; incluso si los parÃ¡metros de la llamada de sistema incluyen un puntero explÃcito, esto es manipulado de forma transparente.”h]”hXPara la mayorÃa de llamadas al sistema la misma implementaciÃ³n 64-bit puede ser invocada incluso cuando el programa de userspace es en si mismo 32-bit; incluso si los parÃ¡metros de la llamada de sistema incluyen un puntero explÃcito, esto es manipulado de forma transparente.”…””}”(hjfhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M0hjUhžhubh¨)”}”(hŒ˜Sin embargo, existe un par de situaciones donde se necesita una capa de compatibilidad para lidiar con las diferencias de tamaÃ±o entre 32-bit y 64-bit.”h]”hŒ˜Sin embargo, existe un par de situaciones donde se necesita una capa de compatibilidad para lidiar con las diferencias de tamaÃ±o entre 32-bit y 64-bit.”…””}”(hjthžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M5hjUhžhubh¨)”}”(hXLa primera es si el kernel 64-bit tambiÃ©n soporta programas del userspace 32-bit, y por lo tanto necesita analizar areas de memoria del (``__user``) que podrÃan tener valores tanto 32-bit como 64-bit. En particular esto se necesita siempre que un argumento de la llamada a sistema es:”h]”(hŒŠLa primera es si el kernel 64-bit tambiÃ©n soporta programas del userspace 32-bit, y por lo tanto necesita analizar areas de memoria del (”…””}”(hj‚hžhhŸNh Nubj )”}”(hŒ ``__user``”h]”hŒ__user”…””}”(hjŠhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj‚ubhŒŠ) que podrÃan tener valores tanto 32-bit como 64-bit. En particular esto se necesita siempre que un argumento de la llamada a sistema es:”…””}”(hj‚hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M9hjUhžhubjØ)”}”(hX- un puntero a un puntero - un puntero a un struc conteniendo un puntero (por ejemplo ``struct iovec __user *``) - un puntero a un type entero de tamaÃ±o entero variable (``time_t``, ``off_t``, ``long``, ...) - un puntero a un struct conteniendo un type entero de tamaÃ±o variable. ”h]”jÞ)”}”(hhh]”(jã)”}”(hŒun puntero a un puntero”h]”h¨)”}”(hj«h]”hŒun puntero a un puntero”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M>hj©ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj¦ubjã)”}”(hŒTun puntero a un struc conteniendo un puntero (por ejemplo ``struct iovec __user *``)”h]”h¨)”}”(hŒTun puntero a un struc conteniendo un puntero (por ejemplo ``struct iovec __user *``)”h]”(hŒ:un puntero a un struc conteniendo un puntero (por ejemplo ”…””•åû}”(hjÄhžhhŸNh Nubj )”}”(hŒ``struct iovec __user *``”h]”hŒstruct iovec __user *”…””}”(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 M?hjÀubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj¦ubjã)”}”(hŒ]un puntero a un type entero de tamaÃ±o entero variable (``time_t``, ``off_t``, ``long``, ...)”h]”h¨)”}”(hŒ]un puntero a un type entero de tamaÃ±o entero variable (``time_t``, ``off_t``, ``long``, ...)”h]”(hŒ8un puntero a un type entero de tamaÃ±o entero variable (”…””}”(hjîhžhhŸNh Nubj )”}”(hŒ ``time_t``”h]”hŒtime_t”…””}”(hjöhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjîubhŒ, ”…””}”(hjîhžhhŸNh Nubj )”}”(hŒ ``off_t``”h]”hŒoff_t”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjîubhŒ, ”…””}”(hjîhžhhŸNh Nubj )”}”(hŒ``long``”h]”hŒlong”…””}”(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 MAhjêubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj¦ubjã)”}”(hŒGun puntero a un struct conteniendo un type entero de tamaÃ±o variable. ”h]”h¨)”}”(hŒFun puntero a un struct conteniendo un type entero de tamaÃ±o variable.”h]”hŒFun puntero a un struct conteniendo un type entero de tamaÃ±o variable.”…””}”(hj< hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MChj8 ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj¦ubeh}”(h]”h ]”h"]”h$]”h&]”j¯j°uh1jÝhŸhØh M>hj¢ubah}”(h]”h ]”h"]”h$]”h&]”uh1j×hŸhØh M>hjUhžhubh¨)”}”(hX°La segunda situaciÃ³n que requiere una capa de compatibilidad es cuando uno de los argumentos de la llamada a sistema tiene un argumento que es explÃcitamente 64-bit incluso sobre arquitectura 32-bit, por ejemplo ``loff_t`` o ``__u64``. En este caso, el valor que llega a un kernel 64-bit desde una aplicaciÃ³n de 32-bit se separarÃ¡ en dos valores de 32-bit, los que luego necesitan ser reensamblados en la capa de compatibilidad.”h]”(hŒÖLa segunda situaciÃ³n que requiere una capa de compatibilidad es cuando uno de los argumentos de la llamada a sistema tiene un argumento que es explÃcitamente 64-bit incluso sobre arquitectura 32-bit, por ejemplo ”…””}”(hj\ hžhhŸNh Nubj )”}”(hŒ ``loff_t``”h]”hŒloff_t”…””}”(hjd hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj\ ubhŒ o ”…””}”(hj\ hžhhŸNh Nubj )”}”(hŒ ``__u64``”h]”hŒ__u64”…””}”(hjv hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj\ ubhŒÄ. En este caso, el valor que llega a un kernel 64-bit desde una aplicaciÃ³n de 32-bit se separarÃ¡ en dos valores de 32-bit, los que luego necesitan ser reensamblados en la capa de compatibilidad.”…””}”(hj\ hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MEhjUhžhubh¨)”}”(hX%(Note que un argumento de una llamada a sistema que sea un puntero a un type explicitamente de 64-bit **no** necesita una capa de compatibilidad; por ejemplo, los argumentos de :manpage:`splice(2)`) del tipo ``loff_t __user *`` no significan la necesidad de una llamada a sistema ``compat_``.)”h]”(hŒf(Note que un argumento de una llamada a sistema que sea un puntero a un type explicitamente de 64-bit ”…””}”(hjŽ hžhhŸNh NubhŒstrong”“”)”}”(hŒ**no**”h]”hŒno”…””}”(hj˜ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j– hjŽ ubhŒE necesita una capa de compatibilidad; por ejemplo, los argumentos de ”…””}”(hjŽ hžhhŸNh NubjZ)”}”(hŒ:manpage:`splice(2)`”h]”hŒ splice(2)”…””}”(hjª hžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒ splice(2)”jmŒsplice”jojpuh1jYhjŽ ubhŒ) del tipo ”…””}”(hjŽ hžhhŸNh Nubj )”}”(hŒ``loff_t __user *``”h]”hŒloff_t __user *”…””}”(hj¾ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjŽ ubhŒ5 no significan la necesidad de una llamada a sistema ”…””}”(hjŽ hžhhŸNh Nubj )”}”(hŒ``compat_``”h]”hŒcompat_”…””}”(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 MLhjUhžhubh¨)”}”(hXLa versiÃ³n compatible de la llamada de sistema se llama ``compat_sys_xyzzy()``, y se agrega con la macro ``COMPAT_SYSCALL_DEFINEn``, de manera anÃ¡loga a SYSCALL_DEFINEn. Esta versiÃ³n de la implementaciÃ³n se ejecuta como parte de un kernel de 64-bit, pero espera recibir parametros con valores 32-bit y hace lo que tenga que hacer para tratar con ellos. (TÃpicamente, la versiÃ³n ``compat_sys_`` convierte los valores a versiones de 64 bits y llama a la versiÃ³n ``sys_`` o ambas llaman a una funciÃ³n de implementaciÃ³n interna comÃºn.)”h]”(hŒ9La versiÃ³n compatible de la llamada de sistema se llama ”…””}”(hjè hžhhŸNh Nubj )”}”(hŒ``compat_sys_xyzzy()``”h]”hŒcompat_sys_xyzzy()”…””}”(hjð hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjè ubhŒ, y se agrega con la macro ”…””}”(hjè hžhhŸNh Nubj )”}”(hŒ``COMPAT_SYSCALL_DEFINEn``”h]”hŒCOMPAT_SYSCALL_DEFINEn”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjè ubhŒü, de manera anÃ¡loga a SYSCALL_DEFINEn. Esta versiÃ³n de la implementaciÃ³n se ejecuta como parte de un kernel de 64-bit, pero espera recibir parametros con valores 32-bit y hace lo que tenga que hacer para tratar con ellos. (TÃpicamente, la versiÃ³n ”…””}”(hjè hžhhŸNh Nubj )”}”(hŒ``compat_sys_``”h]”hŒcompat_sys_”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjè ubhŒD convierte los valores a versiones de 64 bits y llama a la versiÃ³n ”…””}”(hjè hžhhŸNh Nubj )”}”(hŒ``sys_``”h]”hŒsys_”…””}”(hj&hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjè ubhŒB o ambas llaman a una funciÃ³n de implementaciÃ³n interna comÃºn.)”…””}”(hjè hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MRhjUhžhubh¨)”}”(hŒÒEl punto de entrada compat tambiÃ©n necesita un prototipo de funciÃ³n correspondiente, en ``include/linux/compat.h``, marcado como asmlinkage para igualar la forma en que las llamadas al sistema son invocadas::”h]”(hŒZEl punto de entrada compat tambiÃ©n necesita un prototipo de funciÃ³n correspondiente, en ”…””}”(hj>hžhhŸNh Nubj )”}”(hŒ``include/linux/compat.h``”h]”hŒinclude/linux/compat.h”…””}”(hjFhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj>ubhŒ], marcado como asmlinkage para igualar la forma en que las llamadas al sistema son invocadas:”…””}”(hj>hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M[hjUhžhubjµ)”}”(hŒ&asmlinkage long compat_sys_xyzzy(...);”h]”hŒ&asmlinkage long compat_sys_xyzzy(...);”…””}”hj^sbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh M_hjUhžhubh¨)”}”(hX:Si la nueva llamada al sistema involucra una estructura que que se dispone de forma distinta en sistema de 32-bit y 64-bit, digamos ``struct xyzzy_args``, entonces el archivo de cabecera include/linux/compat.h tambiÃ©n deberÃa incluir una versiÃ³n compatible de la estructura (``struct compat_xyzzy_args``) donde cada campo de tamaÃ±o variable tiene el tipo ``compat_`` apropiado que corresponde al tipo en ``struct xyzzy_args``. La rutina ``compat_sys_xyzzy()`` puede entonces usar esta estructura ``compat_`` para analizar los argumentos de una invocaciÃ³n de 32-bit.”h]”(hŒ„Si la nueva llamada al sistema involucra una estructura que que se dispone de forma distinta en sistema de 32-bit y 64-bit, digamos ”…””}”(hjlhžhhŸNh Nubj )”}”(hŒ``struct xyzzy_args``”h]”hŒstruct xyzzy_args”…””}”(hjthžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjlubhŒ}, entonces el archivo de cabecera include/linux/compat.h tambiÃ©n deberÃa incluir una versiÃ³n compatible de la estructura (”…””}”(hjlhžhhŸNh Nubj )”}”(hŒ``struct compat_xyzzy_args``”h]”hŒstruct compat_xyzzy_args”…””}”(hj†hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjlubhŒ5) donde cada campo de tamaÃ±o variable tiene el tipo ”…””}”(hjlhžhhŸNh Nubj )”}”(hŒ``compat_``”h]”hŒcompat_”…””}”(hj˜hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjlubhŒ& apropiado que corresponde al tipo en ”…””}”(hjlhžhhŸNh Nubj )”}”(hŒ``struct xyzzy_args``”h]”hŒstruct xyzzy_args”…””}”(hjªhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjlubhŒ. La rutina ”…””}”(hjlhžhhŸNh Nubj )”}”(hŒ``compat_sys_xyzzy()``”h]”hŒcompat_sys_xyzzy()”…””}”(hj¼hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjlubhŒ% puede entonces usar esta estructura ”…””}”(hjlhžhhŸNh Nubj )”}”(hŒ``compat_``”h]”hŒcompat_”…””}”(hjÎhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjlubhŒ; para analizar los argumentos de una invocaciÃ³n de 32-bit.”…””}”(hjlhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MahjUhžhubh¨)”}”(hŒPor ejemplo, si hay campos::”h]”hŒPor ejemplo, si hay campos:”…””}”(hjæhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MkhjUhžhubjµ)”}”(hŒlstruct xyzzy_args { const char __user *ptr; __kernel_long_t varying_val; u64 fixed_val; /* ... */ };”h]”hŒlstruct xyzzy_args { const char __user *ptr; __kernel_long_t varying_val; u64 fixed_val; /* ... */ };”…””}”hjôsbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh MmhjUhžhubh¨)”}”(hŒDen struct xyzzy_args, entonces struct compat_xyzzy_args debe tener::”h]”hŒCen struct xyzzy_args, entonces struct compat_xyzzy_args debe tener:”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MthjUhžhubjµ)”}”(hŒlstruct compat_xyzzy_args { compat_uptr_t ptr; compat_long_t varying_val; u64 fixed_val; /* ... */ };”h]”hŒlstruct compat_xyzzy_args { compat_uptr_t ptr; compat_long_t varying_val; u64 fixed_val; /* ... */ };”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh MvhjUhžhubh¨)”}”(hŒÏla lista genÃ©rica de llamadas al sistema tambiÃ©n necesita ajustes para permitir la versiÃ³n compat; la entrada en ``include/uapi/asm-generic/unistd.h`` deberÃa usar ``__SC_COMP`` en vez de ``__SYSCALL``::”h]”(hŒtla lista genÃ©rica de llamadas al sistema tambiÃ©n necesita ajustes para permitir la versiÃ³n compat; la entrada en ”…””}”(hjhžhhŸNh Nubj )”}”(hŒ%``include/uapi/asm-generic/unistd.h``”h]”hŒ!include/uapi/asm-generic/unistd.h”…””}”(hj&hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒ deberÃa usar ”…””}”(hjhžhhŸNh Nubj )”}”(hŒ ``__SC_COMP``”h]”hŒ __SC_COMP”…””}”(hj8hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒ en vez de ”…””}”(hjhžhhŸNh Nubj )”}”(hŒ ``__SYSCALL``”h]”hŒ __SYSCALL”…””}”(hjJhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒ:”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M}hjUhžhubjµ)”}”(hŒI#define __NR_xyzzy 292 __SC_COMP(__NR_xyzzy, sys_xyzzy, compat_sys_xyzzy)”h]”hŒI#define __NR_xyzzy 292 __SC_COMP(__NR_xyzzy, sys_xyzzy, compat_sys_xyzzy)”…””}”hjbsbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh M‚hjUhžhubh¨)”}”(hŒPara resumir, necesita:”h]”hŒPara resumir, necesita:”…””}”(hjphžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M…hjUhžhubjØ)”}”(hXA- una ``COMPAT_SYSCALL_DEFINEn(xyzzy, ...)`` para el punto de entrada de compat. - el prototipo correspondiente en ``include/linux/compat.h`` - (en caso de ser necesario) un struct de mapeo de 32-bit en ``include/linux/compat.h`` - una instancia de ``__SC_COMP`` no ``__SYSCALL`` en ``include/uapi/asm-generic/unistd.h`` ”h]”jÞ)”}”(hhh]”(jã)”}”(hŒNuna ``COMPAT_SYSCALL_DEFINEn(xyzzy, ...)`` para el punto de entrada de compat.”h]”h¨)”}”(hj‡h]”(hŒuna ”…””}”(hj‰hžhhŸNh Nubj )”}”(hŒ&``COMPAT_SYSCALL_DEFINEn(xyzzy, ...)``”h]”hŒ"COMPAT_SYSCALL_DEFINEn(xyzzy, ...)”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj‰ubhŒ$ para el punto de entrada de compat.”…””}”(hj‰hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M‡hj…ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj‚ubjã)”}”(hŒ:el prototipo correspondiente en ``include/linux/compat.h``”h]”h¨)”}”(hj°h]”(hŒ el prototipo correspondiente en ”…””}”(hj²hžhhŸNh Nubj )”}”(hŒ``include/linux/compat.h``”h]”hŒinclude/linux/compat.h”…””}”(hj¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj²ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mˆhj®ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj‚ubjã)”}”(hŒU(en caso de ser necesario) un struct de mapeo de 32-bit en ``include/linux/compat.h``”h]”h¨)”}”(hjÕh]”(hŒ;(en caso de ser necesario) un struct de mapeo de 32-bit en ”…””}”(hj×hžhhŸNh Nubj )”}”(hŒ``include/linux/compat.h``”h]”hŒinclude/linux/compat.h”…””}”(hjÞhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj×ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M‰hjÓubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj‚ubjã)”}”(hŒYuna instancia de ``__SC_COMP`` no ``__SYSCALL`` en ``include/uapi/asm-generic/unistd.h`` ”h]”h¨)”}”(hŒXuna instancia de ``__SC_COMP`` no ``__SYSCALL`` en ``include/uapi/asm-generic/unistd.h``”h]”(hŒuna instancia de ”…””}”(hjühžhhŸNh Nubj )”}”(hŒ ``__SC_COMP``”h]”hŒ __SC_COMP”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjüubhŒ no ”…””}”(hjühžhhŸNh Nubj )”}”(hŒ ``__SYSCALL``”h]”hŒ __SYSCALL”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjüubhŒ en ”…””}”(hjühžhhŸNh Nubj )”}”(hŒ%``include/uapi/asm-generic/unistd.h``”h]”hŒ!include/uapi/asm-generic/unistd.h”…””}”(hj(hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjüubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MŠhjøubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj‚ubeh}”(h]”h ]”h"]”h$]”h&]”j¯j°uh1jÝhŸhØh M‡hj~ubah}”(h]”h ]”h"]”h$]”h&]”uh1j×hŸhØh M‡hjUhžhubeh}”(h]”Œ.compatibilidad-de-llamadas-de-sistema-generica”ah ]”h"]”Œ1compatibilidad de llamadas de sistema (genÃ©rica)”ah$]”h&]”uh1jqhjshžhhŸhØh M.ubjr)”}”(hhh]”(jw)”}”(hŒ+Compatibilidad de Llamadas de Sistema (x86)”h]”hŒ+Compatibilidad de Llamadas de Sistema (x86)”…””}”(hjYhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhjVhžhhŸhØh Mubh¨)”}”(hŒšPara conectar la arquitectura x86 de una llamada al sistema con una versiÃ³n de compatibilidad, las entradas en las tablas de syscall deben ser ajustadas.”h]”hŒšPara conectar la arquitectura x86 de una llamada al sistema con una versiÃ³n de compatibilidad, las entradas en las tablas de syscall deben ser ajustadas.”…””}”(hjghžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MhjVhžhubh¨)”}”(hŒÙPrimero, la entrada en ``arch/x86/entry/syscalls/syscall_32.tbl`` recibe una columna extra para indicar que un programa del userspace de 32-bit corriendo en un kernel de 64-bit debe llegar al punto de entrada compat::”h]”(hŒPrimero, la entrada en ”…””}”(hjuhžhhŸNh Nubj )”}”(hŒ*``arch/x86/entry/syscalls/syscall_32.tbl``”h]”hŒ&arch/x86/entry/syscalls/syscall_32.tbl”…””}”(hj}hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjuubhŒ— recibe una columna extra para indicar que un programa del userspace de 32-bit corriendo en un kernel de 64-bit debe llegar al punto de entrada compat:”…””}”(hjuhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M“hjVhžhubjµ)”}”(hŒ=380 i386 xyzzy sys_xyzzy __ia32_compat_sys_xyzzy”h]”hŒ=380 i386 xyzzy sys_xyzzy __ia32_compat_sys_xyzzy”…””}”hj•sbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh M—hjVhžhubh¨)”}”(hŒæSegundo, tienes que averiguar quÃ© deberÃa pasar para la versiÃ³n x32 ABI de la nueva llamada al sistema. AquÃ hay una elecciÃ³n: el diseÃ±o de los argumentos deberÃa coincidir con la versiÃ³n de 64-bit o la versiÃ³n de 32-bit.”h]”hŒæSegundo, tienes que averiguar quÃ© deberÃa pasar para la versiÃ³n x32 ABI de la nueva llamada al sistema. AquÃ hay una elecciÃ³n: el diseÃ±o de los argumentos deberÃa coincidir con la versiÃ³n de 64-bit o la versiÃ³n de 32-bit.”…””}”(hj£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M™hjVhžhubh¨)”}”(hXSi hay involucrado un puntero-a-puntero, la decisiÃ³n es fÃ¡cil: x32 es ILP32, por lo que el diseÃ±o debe coincidir con la versiÃ³n 32-bit, y la entrada en ``arch/x86/entry/syscalls/syscall_64.tbl`` se divide para que progamas 32-bit lleguen al envoltorio de compatibilidad::”h]”(hŒœSi hay involucrado un puntero-a-puntero, la decisiÃ³n es fÃ¡cil: x32 es ILP32, por lo que el diseÃ±o debe coincidir con la versiÃ³n 32-bit, y la entrada en ”…””}”(hj±hžhhŸNh Nubj )”}”(hŒ*``arch/x86/entry/syscalls/syscall_64.tbl``”h]”hŒ&arch/x86/entry/syscalls/syscall_64.tbl”…””}”(hj¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj±ubhŒL se divide para que progamas 32-bit lleguen al envoltorio de compatibilidad:”…””}”(hj±hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MžhjVhžhubjµ)”}”(hŒ\333 64 xyzzy sys_xyzzy ... 555 x32 xyzzy __x32_compat_sys_xyzzy”h]”hŒ\333 64 xyzzy sys_xyzzy ... 555 x32 xyzzy __x32_compat_sys_xyzzy”…””}”hjÑsbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh M£hjVhžhubh¨)”}”(hŒÁSi no hay punteros involucrados, entonces es preferible reutilizar el system call 64-bit para el x32 ABI (y consecuentemente la entrada en arch/x86/entry/syscalls/syscall_64.tbl no se cambia).”h]”hŒÁSi no hay punteros involucrados, entonces es preferible reutilizar el system call 64-bit para el x32 ABI (y consecuentemente la entrada en arch/x86/entry/syscalls/syscall_64.tbl no se cambia).”…””}”(hjßhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M§hjVhžhubh¨)”}”(hŒ®En cualquier caso, debes revisar que lo tipos involucrados en su diseÃ±o de argumentos de hecho asigne exactamente de x32 (-mx32) a 32-bit(-m32) o equivalentes 64-bit (-m64).”h]”hŒ®En cualquier caso, debes revisar que lo tipos involucrados en su diseÃ±o de argumentos de hecho asigne exactamente de x32 (-mx32) a 32-bit(-m32) o equivalentes 64-bit (-m64).”…””}”(hjíhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M«hjVhžhubeh}”(h]”Œ)compatibilidad-de-llamadas-de-sistema-x86”ah ]”h"]”Œ+compatibilidad de llamadas de sistema (x86)”ah$]”h&]”uh1jqhjshžhhŸhØh Mubjr)”}”(hhh]”(jw)”}”(hŒ.Llamadas de Sistema Retornando a Otros Lugares”h]”hŒ.Llamadas de Sistema Retornando a Otros Lugares”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhjhžhhŸhØh M±ubh¨)”}”(hXGPara la mayorÃa de las llamadas al sistema, una vez que se la llamada al sistema se ha completado el programa de usuario continÃºa exactamente donde quedÃ³ -- en la siguiente instrucciÃ³n, con el stack igual y la mayorÃa de los registros igual que antes de la llamada al sistema, y con el mismo espacio en la memoria virtual.”h]”hXGPara la mayorÃa de las llamadas al sistema, una vez que se la llamada al sistema se ha completado el programa de usuario continÃºa exactamente donde quedÃ³ -- en la siguiente instrucciÃ³n, con el stack igual y la mayorÃa de los registros igual que antes de la llamada al sistema, y con el mismo espacio en la memoria virtual.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M³hjhžhubh¨)”}”(hXSin embargo, unas pocas llamadas al sistema hacen las cosas diferente. Estas podrÃan retornar a una ubicaciÃ³n distinta (``rt_sigreturn``) o cambiar el espacio de memoria (``fork``/``vfork``/``clone``) o incluso de arquitectura (``execve``/``execveat``) del programa.”h]”(hŒzSin embargo, unas pocas llamadas al sistema hacen las cosas diferente. Estas podrÃan retornar a una ubicaciÃ³n distinta (”…””}”(hj"hžhhŸNh Nubj )”}”(hŒ``rt_sigreturn``”h]”hŒrt_sigreturn”…””}”(hj*hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj"ubhŒ#) o cambiar el espacio de memoria (”…””}”(hj"hžhhŸNh Nubj )”}”(hŒ``fork``”h]”hŒfork”…””}”(hj<hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj"ubhŒ/”…””}”(hj"hžhhŸNh Nubj )”}”(hŒ ``vfork``”h]”hŒvfork”…””}”(hjNhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj"ubhŒ/”…””}”hj"sbj )”}”(hŒ ``clone``”h]”hŒclone”…””}”(hj`hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj"ubhŒ) o incluso de arquitectura (”…””}”(hj"hžhhŸNh Nubj )”}”(hŒ ``execve``”h]”hŒexecve”…””}”(hjrhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj"ubhŒ/”…””}”hj"sbj )”}”(hŒ``execveat``”h]”hŒexecveat”…””}”(hj„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj"ubhŒ) del programa.”…””}”(hj"hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M¹hjhžhubh¨)”}”(hXPara permitir esto, la implementaciÃ³n del kernel de la llamada al sistema podrÃa necesitar guardar y restaurar registros adicionales al stak del kernel, brindandole control completo de donde y cÃ³mo la ejecuciÃ³n continÃºa despuÃ©s de la llamada a sistema.”h]”hXPara permitir esto, la implementaciÃ³n del kernel de la llamada al sistema podrÃa necesitar guardar y restaurar registros adicionales al stak del kernel, brindandole control completo de donde y cÃ³mo la ejecuciÃ³n continÃºa despuÃ©s de la llamada a sistema.”…””}”(hjœhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M¾hjhžhubh¨)”}”(hŒ½Esto es arch-specific, pero tÃpicamente involucra definir puntos de entrada assembly que guardan/restauran registros adicionales e invocan el punto de entrada real de la llamada a sistema.”h]”hŒ½Esto es arch-specific, pero tÃpicamente involucra definir puntos de entrada assembly que guardan/restauran registros adicionales e invocan el punto de entrada real de la llamada a sistema.”…””}”(hjªhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MÃhjhžhubh¨)”}”(hŒÓPara x86_64, esto es implementado como un punto de entrada ``stub_xyzzy`` en ``arch/x86/entry/entry_64.S``, y la entrada en la tabla syscall (``arch/x86/entry/syscalls/syscall_32.tbl``) es ajustada para calzar::”h]”(hŒ;Para x86_64, esto es implementado como un punto de entrada ”…””}”(hj¸hžhhŸNh Nubj )”}”(hŒ``stub_xyzzy``”h]”hŒ stub_xyzzy”…””}”(hjÀhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj¸ubhŒ en ”…””}”(hj¸hžhhŸNh Nubj )”}”(hŒ``arch/x86/entry/entry_64.S``”h]”hŒarch/x86/entry/entry_64.S”…””}”(hjÒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj¸ubhŒ$, y la entrada en la tabla syscall (”…””}”(hj¸hžhhŸNh Nubj )”}”(hŒ*``arch/x86/entry/syscalls/syscall_32.tbl``”h]”hŒ&arch/x86/entry/syscalls/syscall_32.tbl”…””}”(hjähžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj¸ubhŒ) es ajustada para calzar:”…””}”(hj¸hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MÇhjhžhubjµ)”}”(hŒ"333 common xyzzy stub_xyzzy”h]”hŒ"333 common xyzzy stub_xyzzy”…””}”hjüsbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh MËhjhžhubh¨)”}”(hŒþEl equivalente para programas 32-bit corriendo en un kernel 64-bit es normalmente llamado ``stub32_xyzzy`` e implementado en ``arch/x86/entry/entry_64_compat.S``, con el correspondiente ajuste en la tabla syscall en ``arch/x86/syscalls/syscall_32.tbl``::”h]”(hŒZEl equivalente para programas 32-bit corriendo en un kernel 64-bit es normalmente llamado ”…””}”(hj hžhhŸNh Nubj )”}”(hŒ``stub32_xyzzy``”h]”hŒstub32_xyzzy”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj ubhŒ e implementado en ”…””}”(hj hžhhŸNh Nubj )”}”(hŒ$``arch/x86/entry/entry_64_compat.S``”h]”hŒ arch/x86/entry/entry_64_compat.S”…””}”(hj$hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj ubhŒ7, con el correspondiente ajuste en la tabla syscall en ”…””}”(hj hžhhŸNh Nubj )”}”(hŒ$``arch/x86/syscalls/syscall_32.tbl``”h]”hŒ arch/x86/syscalls/syscall_32.tbl”…””}”(hj6hž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 MÍhjhžhubjµ)”}”(hŒ6380 i386 xyzzy sys_xyzzy stub32_xyzzy”h]”hŒ6380 i386 xyzzy sys_xyzzy stub32_xyzzy”…””}”hjNsbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh MÒhjhžhubh¨)”}”(hX¬Si la llamada a sistema necesita una capa de compatibilidad (como en la secciÃ³n anterior) entonces la versiÃ³n ``stub32_`` necesita llamar a la versiÃ³n ``compat_sys_`` de la llamada a sistema, en vez de la versiÃ³n nativa de 64-bit. TambiÃ©n, si la implementaciÃ³n de la versiÃ³n x32 ABI no es comun con la versiÃ³n x86_64, entonces su tabla syscall tambiÃ©n necesitarÃ¡ invocar un stub que llame a la versiÃ³n ``compat_sys_``”h]”(hŒpSi la llamada a sistema necesita una capa de compatibilidad (como en la secciÃ³n anterior) entonces la versiÃ³n ”…””}”(hj\hžhhŸNh Nubj )”}”(hŒ``stub32_``”h]”hŒstub32_”…””}”(hjdhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj\ubhŒ necesita llamar a la versiÃ³n ”…””}”(hj\hžhhŸNh Nubj )”}”(hŒ``compat_sys_``”h]”hŒcompat_sys_”…””}”(hjvhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj\ubhŒô de la llamada a sistema, en vez de la versiÃ³n nativa de 64-bit. TambiÃ©n, si la implementaciÃ³n de la versiÃ³n x32 ABI no es comun con la versiÃ³n x86_64, entonces su tabla syscall tambiÃ©n necesitarÃ¡ invocar un stub que llame a la versiÃ³n ”…””}”(hj\hžhhŸNh Nubj )”}”(hŒ``compat_sys_``”h]”hŒcompat_sys_”…””}”(hjˆhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj\ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MÔhjhžhubh¨)”}”(hXIPara completar, tambiÃ©n es agradable configurar un mapeo de modo que el user-mode linux todavÃa funcione -- su tabla syscall referenciarÃ¡ stub_xyzzy, pero el UML construido no incluye una implementaciÃ³n ``arch/x86/entry/entry_64.S``. Arreglar esto es tan simple como agregar un #define a ``arch/x86/um/sys_call_table_64.c``::”h]”(hŒÏPara completar, tambiÃ©n es agradable configurar un mapeo de modo que el user-mode linux todavÃa funcione -- su tabla syscall referenciarÃ¡ stub_xyzzy, pero el UML construido no incluye una implementaciÃ³n ”…””}”(hjœhžhhŸNh Nubj )”}”(hŒ``arch/x86/entry/entry_64.S``”h]”hŒarch/x86/entry/entry_64.S”…””}”(hj¤hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjœubhŒ8. Arreglar esto es tan simple como agregar un #define a ”…””}”(hjœhžhhŸNh Nubj )”}”(hŒ#``arch/x86/um/sys_call_table_64.c``”h]”hŒarch/x86/um/sys_call_table_64.c”…””}”(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 MÛhjhžhubjµ)”}”(hŒ#define stub_xyzzy sys_xyzzy”h]”hŒ#define stub_xyzzy sys_xyzzy”…””}”hjÎsbah}”(h]”h ]”h"]”h$]”h&]”jijjuh1j´hŸhØh Máhjhžhubeh}”(h]”Œ.llamadas-de-sistema-retornando-a-otros-lugares”ah ]”h"]”Œ.llamadas de sistema retornando a otros lugares”ah$]”h&]”uh1jqhjshžhhŸhØh M±ubjr)”}”(hhh]”(jw)”}”(hŒOtros detalles”h]”hŒOtros detalles”…””}”(hjçhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhjähžhhŸhØh Måubh¨)”}”(hŒ³La mayorÃa del kernel trata las llamadas a sistema de manera genÃ©rica, pero estÃ¡ la excepciÃ³n ocasional que pueda requerir actualizaciÃ³n para su llamada a sistema particular.”h]”hŒ³La mayorÃa del kernel trata las llamadas a sistema de manera genÃ©rica, pero estÃ¡ la excepciÃ³n ocasional que pueda requerir actualizaciÃ³n para su llamada a sistema particular.”…””}”(hjõhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mçhjähžhubh¨)”}”(hX El subsistema de auditorÃa es un caso especial; este incluye funciones (arch-specific) que clasifican algunos tipos especiales de llamadas al sistema -- especÃficamente file open (``open``/``openat``), program execution (``execve`` /``execveat``) o operaciones multiplexores de socket (``socketcall``). Si su nueva llamada de sistema es anÃ¡loga a alguna de estas, entonces el sistema auditor debe ser actualizado.”h]”(hŒ¶El subsistema de auditorÃa es un caso especial; este incluye funciones (arch-specific) que clasifican algunos tipos especiales de llamadas al sistema -- especÃficamente file open (”…””}”(hjhžhhŸNh Nubj )”}”(hŒ``open``”h]”hŒopen”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒ/”…””}”(hjhžhhŸNh Nubj )”}”(hŒ ``openat``”h]”hŒopenat”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒ), program execution (”…””}”(hjhžhhŸNh Nubj )”}”(hŒ ``execve``”h]”hŒexecve”…””}”(hj/hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒ /”…””}”(hjhžhhŸNh Nubj )”}”(hŒ``execveat``”h]”hŒexecveat”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒ)) o operaciones multiplexores de socket (”…””}”(hjhžhhŸNh Nubj )”}”(hŒ``socketcall``”h]”hŒ socketcall”…””}”(hjShžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒr). Si su nueva llamada de sistema es anÃ¡loga a alguna de estas, entonces el sistema auditor debe ser actualizado.”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mëhjähžhubh¨)”}”(hŒêMÃ¡s generalmente, si existe una llamada al sistema que sea anÃ¡loga a su nueva llamada al sistema, entonces vale la pena hacer un grep a todo el kernel de la llamada a sistema existente, para revisar que no exista otro caso especial.”h]”hŒêMÃ¡s generalmente, si existe una llamada al sistema que sea anÃ¡loga a su nueva llamada al sistema, entonces vale la pena hacer un grep a todo el kernel de la llamada a sistema existente, para revisar que no exista otro caso especial.”…””}”(hjkhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mòhjähžhubeh}”(h]”Œotros-detalles”ah ]”h"]”Œotros detalles”ah$]”h&]”uh1jqhjshžhhŸhØh Måubjr)”}”(hhh]”(jw)”}”(hŒTesting”h]”hŒTesting”…””}”(hj„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhjhžhhŸhØh Mùubh¨)”}”(hXKUna nueva llamada al sistema debe obviamente ser probada; tambiÃ©n es Ãºtil proveer a los revisores con una demostraciÃ³n de cÃ³mo los programas del userspace usarÃ¡n la llamada al sistema. Una buena forma de combinar estos objetivos es incluir un simple programa self-test en un nuevo directorio bajo ``tools/testing/selftests/``.”h]”(hX.Una nueva llamada al sistema debe obviamente ser probada; tambiÃ©n es Ãºtil proveer a los revisores con una demostraciÃ³n de cÃ³mo los programas del userspace usarÃ¡n la llamada al sistema. Una buena forma de combinar estos objetivos es incluir un simple programa self-test en un nuevo directorio bajo ”…””}”(hj’hžhhŸNh Nubj )”}”(hŒ``tools/testing/selftests/``”h]”hŒtools/testing/selftests/”…””}”(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 Mûhjhžhubh¨)”}”(hX:Para una nueva llamada al sistema, obviamente no habrÃ¡ una funciÃ³n envoltorio libc por lo que el test necesitarÃ¡ ser invocado usando ``syscall()``; tambiÃ©n, si la llamada al sistema involucra una nueva estructura userspace-visible, el encabezado correspondiente necesitarÃ¡ ser instalado para compilar el test.”h]”(hŒˆPara una nueva llamada al sistema, obviamente no habrÃ¡ una funciÃ³n envoltorio libc por lo que el test necesitarÃ¡ ser invocado usando ”…””}”(hj²hžhhŸNh Nubj )”}”(hŒ ``syscall()``”h]”hŒ syscall()”…””}”(hjºhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj²ubhŒ¥; tambiÃ©n, si la llamada al sistema involucra una nueva estructura userspace-visible, el encabezado correspondiente necesitarÃ¡ ser instalado para compilar el test.”…””}”(hj²hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mhjhžhubh¨)”}”(hŒÉAsegure que selftest corra satisfactoriamente en todas las arquitecturas soportadas. Por ejemplo, revise si funciona cuando es compilado como un x86_64 (-m64), x86_32 (-m32) y x32 (-mx32) programa ABI.”h]”hŒÉAsegure que selftest corra satisfactoriamente en todas las arquitecturas soportadas. Por ejemplo, revise si funciona cuando es compilado como un x86_64 (-m64), x86_32 (-m32) y x32 (-mx32) programa ABI.”…””}”(hjÒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mhjhžhubh¨)”}”(hŒºPara pruebas mÃ¡s amplias y exhautivas de la nueva funcionalidad, tambiÃ©n deberÃa considerar agregar tests al Linus Test Project, o al proyecto xfstests para cambios filesystem-related”h]”hŒºPara pruebas mÃ¡s amplias y exhautivas de la nueva funcionalidad, tambiÃ©n deberÃa considerar agregar tests al Linus Test Project, o al proyecto xfstests para cambios filesystem-related”…””}”(hjàhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MhjhžhubjØ)”}”(hŒ`- https://linux-test-project.github.io/ - git://git.kernel.org/pub/scm/fs/xfs/xfstests-dev.git ”h]”jÞ)”}”(hhh]”(jã)”}”(hŒ%https://linux-test-project.github.io/”h]”h¨)”}”(hj÷h]”j6)”}”(hj÷h]”hŒ%https://linux-test-project.github.io/”…””}”(hjühžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j÷uh1j5hjùubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mhjõubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjòubjã)”}”(hŒ6git://git.kernel.org/pub/scm/fs/xfs/xfstests-dev.git ”h]”h¨)”}”(hŒ4git://git.kernel.org/pub/scm/fs/xfs/xfstests-dev.git”h]”hŒ4git://git.kernel.org/pub/scm/fs/xfs/xfstests-dev.git”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjòubeh}”(h]”h ]”h"]”h$]”h&]”j¯j°uh1jÝhŸhØh Mhjîubah}”(h]”h ]”h"]”h$]”h&]”uh1j×hŸhØh Mhjhžhubeh}”(h]”Œtesting”ah ]”h"]”Œtesting”ah$]”h&]”uh1jqhjshžhhŸhØh Mùubjr)”}”(hhh]”(jw)”}”(hŒMan Page”h]”hŒMan Page”…””}”(hjEhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhjBhžhhŸhØh Mubh¨)”}”(hX-Todas las llamada al sistema nueva deben venir con un man page completo, idealmente usando groff markup, pero texto plano tambiÃ©n funciona. Si se usa groff, es Ãºtil incluir una versiÃ³n ASCII pre-renderizada del man-page en el cover del email para el patchset, para la conveniencia de los revisores.”h]”hX-Todas las llamada al sistema nueva deben venir con un man page completo, idealmente usando groff markup, pero texto plano tambiÃ©n funciona. Si se usa groff, es Ãºtil incluir una versiÃ³n ASCII pre-renderizada del man-page en el cover del email para el patchset, para la conveniencia de los revisores.”…””}”(hjShžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MhjBhžhubh¨)”}”(hŒƒEl man page debe ser cc'do a linux-man@vger.kernel.org Para mÃ¡s detalles, revise https://www.kernel.org/doc/man-pages/patches.html”h]”(hŒEl man page debe ser ccâ€™do a ”…””}”(hjahžhhŸNh Nubj6)”}”(hŒlinux-man@vger.kernel.org”h]”hŒlinux-man@vger.kernel.org”…””}”(hjihžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ mailto:linux-man@vger.kernel.org”uh1j5hjaubhŒ Para mÃ¡s detalles, revise ”…””}”(hjahžhhŸNh Nubj6)”}”(hŒ1https://www.kernel.org/doc/man-pages/patches.html”h]”hŒ1https://www.kernel.org/doc/man-pages/patches.html”…””}”(hj}hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”juh1j5hjaubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MhjBhžhubeh}”(h]”Œman-page”ah ]”h"]”Œman page”ah$]”h&]”uh1jqhjshžhhŸhØh Mubjr)”}”(hhh]”(jw)”}”(hŒ0No invoque las llamadas de sistemas en el kernel”h]”hŒ0No invoque las llamadas de sistemas en el kernel”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhjšhžhhŸhØh M!ubh¨)”}”(hXLas llamadas al sistema son, cÃ³mo se declarÃ³ mÃ¡s arriba, puntos de interacciÃ³n entre el userspace y el kernel. Por lo tanto, las funciones de llamada al sistema como ``sys_xyzzy()`` o ``compat_sys_xyzzy()`` deberÃan ser llamadas sÃ³lo desde el userspace vÃa la tabla de syscall, pero no de otro lugar en el kernel. Si la funcionalidad syscall es Ãºtil para ser usada dentro del kernel, necesita ser compartida entre syscalls nuevas o antiguas, o necesita ser compartida entre una syscall y su variante de compatibilidad, esta deberÃa ser implementada mediante una funciÃ³n "helper" (como ``ksys_xyzzy()``). Esta funciÃ³n del kernel puede ahora ser llamada dentro del syscall stub (``sys_xyzzy()``), la syscall stub de compatibilidad (``compat_sys_xyzzy()``), y/o otro cÃ³digo del kernel.”h]”(hŒªLas llamadas al sistema son, cÃ³mo se declarÃ³ mÃ¡s arriba, puntos de interacciÃ³n entre el userspace y el kernel. Por lo tanto, las funciones de llamada al sistema como ”…””}”(hj«hžhhŸNh Nubj )”}”(hŒ``sys_xyzzy()``”h]”hŒsys_xyzzy()”…””}”(hj³hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj«ubhŒ o ”…””}”(hj«hžhhŸNh Nubj )”}”(hŒ``compat_sys_xyzzy()``”h]”hŒcompat_sys_xyzzy()”…””}”(hjÅhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj«ubhX… deberÃan ser llamadas sÃ³lo desde el userspace vÃa la tabla de syscall, pero no de otro lugar en el kernel. Si la funcionalidad syscall es Ãºtil para ser usada dentro del kernel, necesita ser compartida entre syscalls nuevas o antiguas, o necesita ser compartida entre una syscall y su variante de compatibilidad, esta deberÃa ser implementada mediante una funciÃ³n â€œhelperâ€ (como ”…””}”(hj«hžhhŸNh Nubj )”}”(hŒ``ksys_xyzzy()``”h]”hŒksys_xyzzy()”…””}”(hj×hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj«ubhŒM). Esta funciÃ³n del kernel puede ahora ser llamada dentro del syscall stub (”…””}”(hj«hžhhŸNh Nubj )”}”(hŒ``sys_xyzzy()``”h]”hŒsys_xyzzy()”…””}”(hjéhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj«ubhŒ&), la syscall stub de compatibilidad (”…””}”(hj«hžhhŸNh Nubj )”}”(hŒ``compat_sys_xyzzy()``”h]”hŒcompat_sys_xyzzy()”…””}”(hjûhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj«ubhŒ), y/o otro cÃ³digo del kernel.”…””}”(hj«hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M#hjšhžhubh¨)”}”(hXšAl menos en 64-bit x86, serÃ¡ un requerimiento duro desde la v4.17 en adelante no invocar funciones de llamada al sistema (system call) en el kernel. Este usa una convenciÃ³n de llamada diferente para llamadas al sistema donde ``struct pt_regs`` es decodificado on-the-fly en un envoltorio syscall que luego entrega el procesamiento al syscall real. Esto significa que sÃ³lo aquellos parÃ¡metros que son realmente necesarios para una syscall especÃfica son pasados durante la entrada del syscall, en vez de llenar en seis registros de CPU con contenido random del userspace todo el tiempo (los cuales podrÃan causar serios problemas bajando la cadena de llamadas).”h]”(hŒãAl menos en 64-bit x86, serÃ¡ un requerimiento duro desde la v4.17 en adelante no invocar funciones de llamada al sistema (system call) en el kernel. Este usa una convenciÃ³n de llamada diferente para llamadas al sistema donde ”…””}”(hjhžhhŸNh Nubj )”}”(hŒ``struct pt_regs``”h]”hŒstruct pt_regs”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhX¥ es decodificado on-the-fly en un envoltorio syscall que luego entrega el procesamiento al syscall real. Esto significa que sÃ³lo aquellos parÃ¡metros que son realmente necesarios para una syscall especÃfica son pasados durante la entrada del syscall, en vez de llenar en seis registros de CPU con contenido random del userspace todo el tiempo (los cuales podrÃan causar serios problemas bajando la cadena de llamadas).”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M/hjšhžhubh¨)”}”(hŒÑMÃ¡s aÃºn, reglas sobre cÃ³mo se deberÃa acceder a la data pueden diferir entre la data del kernel y la data de usuario. Esta es otra razÃ³n por la cual llamar a ``sys_xyzzy()`` es generalmente una mala idea.”h]”(hŒ£MÃ¡s aÃºn, reglas sobre cÃ³mo se deberÃa acceder a la data pueden diferir entre la data del kernel y la data de usuario. Esta es otra razÃ³n por la cual llamar a ”…””}”(hj3hžhhŸNh Nubj )”}”(hŒ``sys_xyzzy()``”h]”hŒsys_xyzzy()”…””}”(hj;hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj3ubhŒ es generalmente una mala idea.”…””}”(hj3hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M:hjšhžhubh¨)”}”(hŒ´Excepciones a esta regla estÃ¡n permitidas solamente en overrides especÃficos de arquitectura, envoltorios de compatibilidad especÃficos de arquitectura, u otro cÃ³digo en arch/.”h]”hŒ´Excepciones a esta regla estÃ¡n permitidas solamente en overrides especÃficos de arquitectura, envoltorios de compatibilidad especÃficos de arquitectura, u otro cÃ³digo en arch/.”…””}”(hjShžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M>hjšhžhubeh}”(h]”Œ0no-invoque-las-llamadas-de-sistemas-en-el-kernel”ah ]”h"]”Œ0no invoque las llamadas de sistemas en el kernel”ah$]”h&]”uh1jqhjshžhhŸhØh M!ubjr)”}”(hhh]”(jw)”}”(hŒReferencias y fuentes”h]”hŒReferencias y fuentes”…””}”(hjlhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jvhjihžhhŸhØh MDubjØ)”}”(hX‡- ArtÃculo LWN de Michael Kerrisk sobre el uso de argumentos flags en llamadas al sistema: https://lwn.net/Articles/585415/ - ArtÃculo LWN de Michael Kerrisk sobre cÃ³mo manejar flags desconocidos en una llamada al sistema: https://lwn.net/Articles/588444/ - ArtÃculo LWN de Jake Edge describiendo restricciones en argumentos en 64-bit system call: https://lwn.net/Articles/311630/ - Par de artÃculos LWN de David Drysdale que describen la ruta de implementaciÃ³n de llamadas al sistema en detalle para v3.14: - https://lwn.net/Articles/604287/ - https://lwn.net/Articles/604515/ - Requerimientos arquitectura-especÃficos para llamadas al sistema son discutidos en el :manpage:`syscall(2)` man-page: http://man7.org/linux/man-pages/man2/syscall.2.html#NOTES - RecopilaciÃ³n de emails de Linus Torvalds discutiendo problemas con ``ioctl()``: https://yarchive.net/comp/linux/ioctl.html - "How to not invent kernel interfaces", Arnd Bergmann, https://www.ukuug.org/events/linux2007/2007/papers/Bergmann.pdf - ArtÃculo LWN de Michael Kerrisk sobre evitar nuevos usos de CAP_SYS_ADMIN: https://lwn.net/Articles/486306/ - Recomendaciones de Andrew Morton que toda la informaciÃ³n relacionada a una nueva llamada al sistema debe venir en el mismo hilo de correos: https://lore.kernel.org/r/20140724144747.3041b208832bbdf9fbce5d96@linux-foundation.org - Recomendaciones de Michael Kerrisk que una nueva llamada al sistema debe venir con un man-page: https://lore.kernel.org/r/CAKgNAkgMA39AfoSoA5Pe1r9N+ZzfYQNvNPvcRN7tOvRb8+v06Q@mail.gmail.com - Sugerencias de Thomas Gleixner que conexiones x86 deben ir en commits separados: https://lore.kernel.org/r/alpine.DEB.2.11.1411191249560.3909@nanos - Sugerencias de Greg Kroah-Hartman que es bueno para las nueva llamadas al sistema que vengan con man-page y selftest: https://lore.kernel.org/r/20140320025530.GA25469@kroah.com - DiscusiÃ³n de Michael Kerrisk de nuevas system call vs. extensiones :manpage:`prctl(2)`: https://lore.kernel.org/r/CAHO5Pa3F2MjfTtfNxa8LbnkeeU8=YJ+9tDqxZpw7Gz59E-4AUg@mail.gmail.com - Sugerencias de Ingo Molnar que llamadas al sistema que involucran mÃºltiples argumentos deben encapsular estos argumentos en una estructura, la cual incluye un campo de tamaÃ±o para futura extensibilidad: https://lore.kernel.org/r/20150730083831.GA22182@gmail.com - Enumerando rarezas por la (re-)utilizaciÃ³n de O_* numbering space flags: - commit 75069f2b5bfb ("vfs: renumber FMODE_NONOTIFY and add to uniqueness check") - commit 12ed2e36c98a ("fanotify: FMODE_NONOTIFY and __O_SYNC in sparc conflict") - commit bb458c644a59 ("Safer ABI for O_TMPFILE") - DiscusiÃ³n de Matthew Wilcox sobre las restricciones en argumentos 64-bit: https://lore.kernel.org/r/20081212152929.GM26095@parisc-linux.org - Recomendaciones de Greg Kroah-Hartman sobre flags desconocidos deben ser vigilados: https://lore.kernel.org/r/20140717193330.GB4703@kroah.com - Recomendaciones de Linus Torvalds que las llamadas al sistema x32 deben favorecer compatibilidad con versiones 64-bit sobre versiones 32-bit: https://lore.kernel.org/r/CA+55aFxfmwfB7jbbrXxa=K7VBYPfAvmu3XOkGrLbB1UFjX1+Ew@mail.gmail.com”h]”jÞ)”}”(hhh]”(jã)”}”(hŒzArtÃculo LWN de Michael Kerrisk sobre el uso de argumentos flags en llamadas al sistema: https://lwn.net/Articles/585415/”h]”h¨)”}”(hŒzArtÃculo LWN de Michael Kerrisk sobre el uso de argumentos flags en llamadas al sistema: https://lwn.net/Articles/585415/”h]”(hŒZArtÃculo LWN de Michael Kerrisk sobre el uso de argumentos flags en llamadas al sistema: ”…””}”(hj…hžhhŸNh Nubj6)”}”(hŒ https://lwn.net/Articles/585415/”h]”hŒ https://lwn.net/Articles/585415/”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”juh1j5hj…ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MFhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒƒArtÃculo LWN de Michael Kerrisk sobre cÃ³mo manejar flags desconocidos en una llamada al sistema: https://lwn.net/Articles/588444/”h]”h¨)”}”(hŒƒArtÃculo LWN de Michael Kerrisk sobre cÃ³mo manejar flags desconocidos en una llamada al sistema: https://lwn.net/Articles/588444/”h]”(hŒcArtÃculo LWN de Michael Kerrisk sobre cÃ³mo manejar flags desconocidos en una llamada al sistema: ”…””}”(hj¬hžhhŸNh Nubj6)”}”(hŒ https://lwn.net/Articles/588444/”h]”hŒ https://lwn.net/Articles/588444/”…””}”(hj´hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j¶uh1j5hj¬ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MIhj¨ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒ{ArtÃculo LWN de Jake Edge describiendo restricciones en argumentos en 64-bit system call: https://lwn.net/Articles/311630/”h]”h¨)”}”(hŒ{ArtÃculo LWN de Jake Edge describiendo restricciones en argumentos en 64-bit system call: https://lwn.net/Articles/311630/”h]”(hŒ[ArtÃculo LWN de Jake Edge describiendo restricciones en argumentos en 64-bit system call: ”…””}”(hjÓhžhhŸNh Nubj6)”}”(hŒ https://lwn.net/Articles/311630/”h]”hŒ https://lwn.net/Articles/311630/”…””}”(hjÛhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jÝuh1j5hjÓubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MKhjÏubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒÈPar de artÃculos LWN de David Drysdale que describen la ruta de implementaciÃ³n de llamadas al sistema en detalle para v3.14: - https://lwn.net/Articles/604287/ - https://lwn.net/Articles/604515/ ”h]”(h¨)”}”(hŒ~Par de artÃculos LWN de David Drysdale que describen la ruta de implementaciÃ³n de llamadas al sistema en detalle para v3.14:”h]”hŒ~Par de artÃculos LWN de David Drysdale que describen la ruta de implementaciÃ³n de llamadas al sistema en detalle para v3.14:”…””}”(hjúhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MMhjöubjØ)”}”(hŒF- https://lwn.net/Articles/604287/ - https://lwn.net/Articles/604515/ ”h]”jÞ)”}”(hhh]”(jã)”}”(hŒ https://lwn.net/Articles/604287/”h]”h¨)”}”(hjh]”j6)”}”(hjh]”hŒ https://lwn.net/Articles/604287/”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”juh1j5hjubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MPhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjubjã)”}”(hŒ!https://lwn.net/Articles/604515/ ”h]”h¨)”}”(hŒ https://lwn.net/Articles/604515/”h]”j6)”}”(hj6h]”hŒ https://lwn.net/Articles/604515/”…””}”(hj8hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j6uh1j5hj4ubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MQhj0ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjubeh}”(h]”h ]”h"]”h$]”h&]”j¯j°uh1jÝhŸhØh MPhjubah}”(h]”h ]”h"]”h$]”h&]”uh1j×hŸhØh MPhjöubeh}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒ°Requerimientos arquitectura-especÃficos para llamadas al sistema son discutidos en el :manpage:`syscall(2)` man-page: http://man7.org/linux/man-pages/man2/syscall.2.html#NOTES”h]”h¨)”}”(hŒ°Requerimientos arquitectura-especÃficos para llamadas al sistema son discutidos en el :manpage:`syscall(2)` man-page: http://man7.org/linux/man-pages/man2/syscall.2.html#NOTES”h]”(hŒWRequerimientos arquitectura-especÃficos para llamadas al sistema son discutidos en el ”…””}”(hjhhžhhŸNh NubjZ)”}”(hŒ:manpage:`syscall(2)`”h]”hŒ syscall(2)”…””}”(hjphžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒ syscall(2)”jmŒsyscall”jojpuh1jYhjhubhŒ man-page: ”…””}”(hjhhžhhŸNh Nubj6)”}”(hŒ9http://man7.org/linux/man-pages/man2/syscall.2.html#NOTES”h]”hŒ9http://man7.org/linux/man-pages/man2/syscall.2.html#NOTES”…””}”(hj„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j†uh1j5hjhubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MShjdubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒ{RecopilaciÃ³n de emails de Linus Torvalds discutiendo problemas con ``ioctl()``: https://yarchive.net/comp/linux/ioctl.html”h]”h¨)”}”(hŒ{RecopilaciÃ³n de emails de Linus Torvalds discutiendo problemas con ``ioctl()``: https://yarchive.net/comp/linux/ioctl.html”h]”(hŒDRecopilaciÃ³n de emails de Linus Torvalds discutiendo problemas con ”…””}”(hj£hžhhŸNh Nubj )”}”(hŒ``ioctl()``”h]”hŒioctl()”…””}”(hj«hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj£ubhŒ: ”…””}”(hj£hžhhŸNh Nubj6)”}”(hŒ*https://yarchive.net/comp/linux/ioctl.html”h]”hŒ*https://yarchive.net/comp/linux/ioctl.html”…””}”(hj½hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j¿uh1j5hj£ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MVhjŸubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒu"How to not invent kernel interfaces", Arnd Bergmann, https://www.ukuug.org/events/linux2007/2007/papers/Bergmann.pdf”h]”h¨)”}”(hŒu"How to not invent kernel interfaces", Arnd Bergmann, https://www.ukuug.org/events/linux2007/2007/papers/Bergmann.pdf”h]”(hŒ:â€œHow to not invent kernel interfacesâ€, Arnd Bergmann, ”…””}”(hjÜhžhhŸNh Nubj6)”}”(hŒ?https://www.ukuug.org/events/linux2007/2007/papers/Bergmann.pdf”h]”hŒ?https://www.ukuug.org/events/linux2007/2007/papers/Bergmann.pdf”…””}”(hjähžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jæuh1j5hjÜubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MXhjØubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒlArtÃculo LWN de Michael Kerrisk sobre evitar nuevos usos de CAP_SYS_ADMIN: https://lwn.net/Articles/486306/”h]”h¨)”}”(hŒlArtÃculo LWN de Michael Kerrisk sobre evitar nuevos usos de CAP_SYS_ADMIN: https://lwn.net/Articles/486306/”h]”(hŒLArtÃculo LWN de Michael Kerrisk sobre evitar nuevos usos de CAP_SYS_ADMIN: ”…””}”(hjhžhhŸNh Nubj6)”}”(hŒ https://lwn.net/Articles/486306/”h]”hŒ https://lwn.net/Articles/486306/”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j uh1j5hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MZhjÿubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒãRecomendaciones de Andrew Morton que toda la informaciÃ³n relacionada a una nueva llamada al sistema debe venir en el mismo hilo de correos: https://lore.kernel.org/r/20140724144747.3041b208832bbdf9fbce5d96@linux-foundation.org”h]”h¨)”}”(hŒãRecomendaciones de Andrew Morton que toda la informaciÃ³n relacionada a una nueva llamada al sistema debe venir en el mismo hilo de correos: https://lore.kernel.org/r/20140724144747.3041b208832bbdf9fbce5d96@linux-foundation.org”h]”(hŒRecomendaciones de Andrew Morton que toda la informaciÃ³n relacionada a una nueva llamada al sistema debe venir en el mismo hilo de correos: ”…””}”(hj*hžhhŸNh Nubj6)”}”(hŒVhttps://lore.kernel.org/r/20140724144747.3041b208832bbdf9fbce5d96@linux-foundation.org”h]”hŒVhttps://lore.kernel.org/r/20140724144747.3041b208832bbdf9fbce5d96@linux-foundation.org”…””}”(hj2hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j4uh1j5hj*ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M\hj&ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒ¼Recomendaciones de Michael Kerrisk que una nueva llamada al sistema debe venir con un man-page: https://lore.kernel.org/r/CAKgNAkgMA39AfoSoA5Pe1r9N+ZzfYQNvNPvcRN7tOvRb8+v06Q@mail.gmail.com”h]”h¨)”}”(hŒ¼Recomendaciones de Michael Kerrisk que una nueva llamada al sistema debe venir con un man-page: https://lore.kernel.org/r/CAKgNAkgMA39AfoSoA5Pe1r9N+ZzfYQNvNPvcRN7tOvRb8+v06Q@mail.gmail.com”h]”(hŒ`Recomendaciones de Michael Kerrisk que una nueva llamada al sistema debe venir con un man-page: ”…””}”(hjQhžhhŸNh Nubj6)”}”(hŒ\https://lore.kernel.org/r/CAKgNAkgMA39AfoSoA5Pe1r9N+ZzfYQNvNPvcRN7tOvRb8+v06Q@mail.gmail.com”h]”hŒ\https://lore.kernel.org/r/CAKgNAkgMA39AfoSoA5Pe1r9N+ZzfYQNvNPvcRN7tOvRb8+v06Q@mail.gmail.com”…””}”(hjYhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j[uh1j5hjQubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh M_hjMubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒ“Sugerencias de Thomas Gleixner que conexiones x86 deben ir en commits separados: https://lore.kernel.org/r/alpine.DEB.2.11.1411191249560.3909@nanos”h]”h¨)”}”(hŒ“Sugerencias de Thomas Gleixner que conexiones x86 deben ir en commits separados: https://lore.kernel.org/r/alpine.DEB.2.11.1411191249560.3909@nanos”h]”(hŒQSugerencias de Thomas Gleixner que conexiones x86 deben ir en commits separados: ”…””}”(hjxhžhhŸNh Nubj6)”}”(hŒBhttps://lore.kernel.org/r/alpine.DEB.2.11.1411191249560.3909@nanos”h]”hŒBhttps://lore.kernel.org/r/alpine.DEB.2.11.1411191249560.3909@nanos”…””}”(hj€hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j‚uh1j5hjxubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mahjtubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒ°Sugerencias de Greg Kroah-Hartman que es bueno para las nueva llamadas al sistema que vengan con man-page y selftest: https://lore.kernel.org/r/20140320025530.GA25469@kroah.com”h]”h¨)”}”(hŒ°Sugerencias de Greg Kroah-Hartman que es bueno para las nueva llamadas al sistema que vengan con man-page y selftest: https://lore.kernel.org/r/20140320025530.GA25469@kroah.com”h]”(hŒvSugerencias de Greg Kroah-Hartman que es bueno para las nueva llamadas al sistema que vengan con man-page y selftest: ”…””}”(hjŸhžhhŸNh Nubj6)”}”(hŒ:https://lore.kernel.org/r/20140320025530.GA25469@kroah.com”h]”hŒ:https://lore.kernel.org/r/20140320025530.GA25469@kroah.com”…””}”(hj§hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j©uh1j5hjŸubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mchj›ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒµDiscusiÃ³n de Michael Kerrisk de nuevas system call vs. extensiones :manpage:`prctl(2)`: https://lore.kernel.org/r/CAHO5Pa3F2MjfTtfNxa8LbnkeeU8=YJ+9tDqxZpw7Gz59E-4AUg@mail.gmail.com”h]”h¨)”}”(hŒµDiscusiÃ³n de Michael Kerrisk de nuevas system call vs. extensiones :manpage:`prctl(2)`: https://lore.kernel.org/r/CAHO5Pa3F2MjfTtfNxa8LbnkeeU8=YJ+9tDqxZpw7Gz59E-4AUg@mail.gmail.com”h]”(hŒDDiscusiÃ³n de Michael Kerrisk de nuevas system call vs. extensiones ”…””}”(hjÆhžhhŸNh NubjZ)”}”(hŒ:manpage:`prctl(2)`”h]”hŒprctl(2)”…””}”(hjÎhžhhŸNh Nubah}”(h]”h ]”jYah"]”h$]”h&]”jijjjkŒprctl(2)”jmŒprctl”jojpuh1jYhjÆubhŒ: ”…””}”(hjÆhžhhŸNh Nubj6)”}”(hŒ\https://lore.kernel.org/r/CAHO5Pa3F2MjfTtfNxa8LbnkeeU8=YJ+9tDqxZpw7Gz59E-4AUg@mail.gmail.com”h]”hŒ\https://lore.kernel.org/r/CAHO5Pa3F2MjfTtfNxa8LbnkeeU8=YJ+9tDqxZpw7Gz59E-4AUg@mail.gmail.com”…””}”(hjâhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jäuh1j5hjÆubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MehjÂubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hXSugerencias de Ingo Molnar que llamadas al sistema que involucran mÃºltiples argumentos deben encapsular estos argumentos en una estructura, la cual incluye un campo de tamaÃ±o para futura extensibilidad: https://lore.kernel.org/r/20150730083831.GA22182@gmail.com”h]”h¨)”}”(hXSugerencias de Ingo Molnar que llamadas al sistema que involucran mÃºltiples argumentos deben encapsular estos argumentos en una estructura, la cual incluye un campo de tamaÃ±o para futura extensibilidad: https://lore.kernel.org/r/20150730083831.GA22182@gmail.com”h]”(hŒÍSugerencias de Ingo Molnar que llamadas al sistema que involucran mÃºltiples argumentos deben encapsular estos argumentos en una estructura, la cual incluye un campo de tamaÃ±o para futura extensibilidad: ”…””}”(hjhžhhŸNh Nubj6)”}”(hŒ:https://lore.kernel.org/r/20150730083831.GA22182@gmail.com”h]”hŒ:https://lore.kernel.org/r/20150730083831.GA22182@gmail.com”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”juh1j5hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mghjýubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hX+Enumerando rarezas por la (re-)utilizaciÃ³n de O_* numbering space flags: - commit 75069f2b5bfb ("vfs: renumber FMODE_NONOTIFY and add to uniqueness check") - commit 12ed2e36c98a ("fanotify: FMODE_NONOTIFY and __O_SYNC in sparc conflict") - commit bb458c644a59 ("Safer ABI for O_TMPFILE") ”h]”(h¨)”}”(hŒIEnumerando rarezas por la (re-)utilizaciÃ³n de O_* numbering space flags:”h]”hŒIEnumerando rarezas por la (re-)utilizaciÃ³n de O_* numbering space flags:”…””}”(hj(hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mjhj$ubjØ)”}”(hŒÛ- commit 75069f2b5bfb ("vfs: renumber FMODE_NONOTIFY and add to uniqueness check") - commit 12ed2e36c98a ("fanotify: FMODE_NONOTIFY and __O_SYNC in sparc conflict") - commit bb458c644a59 ("Safer ABI for O_TMPFILE") ”h]”jÞ)”}”(hhh]”(jã)”}”(hŒPcommit 75069f2b5bfb ("vfs: renumber FMODE_NONOTIFY and add to uniqueness check")”h]”h¨)”}”(hŒPcommit 75069f2b5bfb ("vfs: renumber FMODE_NONOTIFY and add to uniqueness check")”h]”hŒTcommit 75069f2b5bfb (â€œvfs: renumber FMODE_NONOTIFY and add to uniqueness checkâ€)”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mlhj=ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj:ubjã)”}”(hŒOcommit 12ed2e36c98a ("fanotify: FMODE_NONOTIFY and __O_SYNC in sparc conflict")”h]”h¨)”}”(hŒOcommit 12ed2e36c98a ("fanotify: FMODE_NONOTIFY and __O_SYNC in sparc conflict")”h]”hŒScommit 12ed2e36c98a (â€œfanotify: FMODE_NONOTIFY and __O_SYNC in sparc conflictâ€)”…””}”(hjYhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh MnhjUubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj:ubjã)”}”(hŒ0commit bb458c644a59 ("Safer ABI for O_TMPFILE") ”h]”h¨)”}”(hŒ/commit bb458c644a59 ("Safer ABI for O_TMPFILE")”h]”hŒ3commit bb458c644a59 (â€œSafer ABI for O_TMPFILEâ€)”…””}”(hjqhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mphjmubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj:ubeh}”(h]”h ]”h"]”h$]”h&]”j¯j°uh1jÝhŸhØh Mlhj6ubah}”(h]”h ]”h"]”h$]”h&]”uh1j×hŸhØh Mlhj$ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒŒDiscusiÃ³n de Matthew Wilcox sobre las restricciones en argumentos 64-bit: https://lore.kernel.org/r/20081212152929.GM26095@parisc-linux.org”h]”h¨)”}”(hŒŒDiscusiÃ³n de Matthew Wilcox sobre las restricciones en argumentos 64-bit: https://lore.kernel.org/r/20081212152929.GM26095@parisc-linux.org”h]”(hŒKDiscusiÃ³n de Matthew Wilcox sobre las restricciones en argumentos 64-bit: ”…””}”(hj›hžhhŸNh Nubj6)”}”(hŒAhttps://lore.kernel.org/r/20081212152929.GM26095@parisc-linux.org”h]”hŒAhttps://lore.kernel.org/r/20081212152929.GM26095@parisc-linux.org”…””}”(hj£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j¥uh1j5hj›ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mrhj—ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒRecomendaciones de Greg Kroah-Hartman sobre flags desconocidos deben ser vigilados: https://lore.kernel.org/r/20140717193330.GB4703@kroah.com”h]”h¨)”}”(hŒRecomendaciones de Greg Kroah-Hartman sobre flags desconocidos deben ser vigilados: https://lore.kernel.org/r/20140717193330.GB4703@kroah.com”h]”(hŒTRecomendaciones de Greg Kroah-Hartman sobre flags desconocidos deben ser vigilados: ”…””}”(hjÂhžhhŸNh Nubj6)”}”(hŒ9https://lore.kernel.org/r/20140717193330.GB4703@kroah.com”h]”hŒ9https://lore.kernel.org/r/20140717193330.GB4703@kroah.com”…””}”(hjÊhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jÌuh1j5hjÂubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mthj¾ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubjã)”}”(hŒêRecomendaciones de Linus Torvalds que las llamadas al sistema x32 deben favorecer compatibilidad con versiones 64-bit sobre versiones 32-bit: https://lore.kernel.org/r/CA+55aFxfmwfB7jbbrXxa=K7VBYPfAvmu3XOkGrLbB1UFjX1+Ew@mail.gmail.com”h]”h¨)”}”(hŒêRecomendaciones de Linus Torvalds que las llamadas al sistema x32 deben favorecer compatibilidad con versiones 64-bit sobre versiones 32-bit: https://lore.kernel.org/r/CA+55aFxfmwfB7jbbrXxa=K7VBYPfAvmu3XOkGrLbB1UFjX1+Ew@mail.gmail.com”h]”(hŒŽRecomendaciones de Linus Torvalds que las llamadas al sistema x32 deben favorecer compatibilidad con versiones 64-bit sobre versiones 32-bit: ”…””}”(hjéhžhhŸNh Nubj6)”}”(hŒ\https://lore.kernel.org/r/CA+55aFxfmwfB7jbbrXxa=K7VBYPfAvmu3XOkGrLbB1UFjX1+Ew@mail.gmail.com”h]”hŒ\https://lore.kernel.org/r/CA+55aFxfmwfB7jbbrXxa=K7VBYPfAvmu3XOkGrLbB1UFjX1+Ew@mail.gmail.com”…””}”(hjñhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jóuh1j5hjéubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhØh Mvhjåubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj~ubeh}”(h]”h ]”h"]”h$]”h&]”j¯j°uh1jÝhŸhØh MFhjzubah}”(h]”h ]”h"]”h$]”h&]”uh1j×hŸhØh MFhjihžhubeh}”(h]”Œreferencias-y-fuentes”ah ]”h"]”Œreferencias y fuentes”ah$]”h&]”uh1jqhjshžhhŸhØh MDubeh}”(h]”(Œ'agregando-una-nueva-llamada-del-sistema”jpeh ]”h"]”(Œ'agregando una nueva llamada del sistema”Œsp_addsyscalls”eh$]”h&]”uh1jqhhhžhhŸhØh K Œexpect_referenced_by_name”}”j&jesŒexpect_referenced_by_id”}”jpjesubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hØuh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(jvNŒ 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”jPŒ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”}”jp]”jeasŒnameids”}”(j&jpj%j"j°jjÀj½jTjQj" j jájÞjRjOjSjPjjýjájÞj~j{j?j<j—j”jfjcjjuŒ nametypes”}”(j&ˆj%‰j°‰jÀ‰jT‰j" ‰já‰jR‰jS‰j‰já‰j~‰j?‰j—‰jf‰j‰uh}”(jpjsj"jsjj¸j½j³jQjÃj jWjÞj% jOjäjPjUjýjVjÞjj{jäj<jj”jBjcjšjjiuŒ 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Œ4Hyperlink target "sp-addsyscalls" is not referenced.”…””}”hjºsbah}”(h]”h ]”h"]”h$]”h&]”uh1h§hj·ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”hØŒline”Kuh1jµubaŒtransformer”NŒinclude_log”]”Œ