arch_prctl(2) System Calls Manual arch_prctl(2) NOMBRE arch_prctl - fija el estado de un hilo para una arquitectura especifica BIBLIOTECA Biblioteca Estandar C (libc, -lc) SINOPSIS #include /* Definicion de las constantes ARCH_* */ #include /* Definicion de las constantes SYS_* */ #include int syscall(SYS_arch_prctl, int code, unsigned long addr); int syscall(SYS_arch_prctl, int code, unsigned long *addr); Nota: glibc no proporciona un contenedor para arch_prctl() por lo que se requiere el uso de syscall(2). DESCRIPCION arch_prctl() establece el estado del proceso o hilo especifico de la arquitectura. op selecciona una operacion y le pasa el argumento addr; addr se interpreta como un entero largo para las operaciones <>, o como un entero largo * para las operaciones <>. Las subfunciones para la arquitectura x86-64 y x86 son: ARCH_SET_CPUID (desde Linux 4.12) Habilita (addr != 0) o deshabilita (addr == 0) la instruccion cpuid para el hilo que la llama. La instruccion esta habilitada por defecto. Si estuviese deshabilitada, cualquier ejecucion de una instruccion cpuid generara una senal SIGSEGV. Esta funcion se puede usar para emular resultados de cpuid que difieren de los que habria producido el hardware subyacente (por ejemplo, en una configuracion de paravirtualizacion). La configuracion de ARCH_SET_CPUID se conserva en fork(2) y clone(2), pero se restablece al valor predeterminado (es decir, cpuid habilitado) en execve(2). ARCH_GET_CPUID (desde Linux 4.12) Retorna la configuracion del indicador manipulado por ARCH_SET_CPUID como resultado de la llamada al sistema (1 para habilitado, 0 para deshabilitado). addr se ignora. Las subfunciones para la arquitectura x86-64 son: ARCH_SET_FS Establece la base de 64 bits para el registro FS a addr. ARCH_GET_FS Devuelve el valor de base de 64 bits para el registro FS del hilo invocante en la variable unsigned long apuntada por addr. ARCH_SET_GS Establece la base de 64 bits para el registro GS a addr. ARCH_GET_GS Devuelve el valor de base 64 bits para el registro GS del hilo actual en la variable unsigned long apuntada por el parametro addr. VALOR DEVUELTO En caso de exito arch_prctl() devuelve cero. En caso de error se devuelve -1, y errno se define para indicar el tipo de error. ERRORES EFAULT addr apunta a una direccion no asignada o que esta fuera del espacio de direcciones del proceso. EINVAL op no es una operacion valida. ENODEV Se solicito ARCH_SET_CPUID, pero el hardware subyacente no incluye soporte para error de CPUID. EPERM addr esta fuera del espacio de direcciones. ESTANDARES Linux/x86-64. NOTAS En la actualidad arch_prctl() es soportada solamente por la plataforma Linux/x86-64 para programas de 64 bits. La base de 64 bits cambia cuando se carga un nuevo selector de segmento de 32 bits. ARCH_SET_GS esta deshabilitado en algunos nucleos. Los cambios de contexto para bases de segmentos de 64 bits son bastante costosos. Como optimizacion, siempre que se use una direccion base TLS de 32 bits, arch_prctl() puede usar una entrada TLS real como si se hubiera llamado a set_thread_area(2), en lugar de manipular directamente el registro base del segmento. La memoria en los primeros 2 GB del espacio de direcciones se puede asignar usando mmap(2) con el indicador MAP_32BIT. Debido a la optimizacion mencionada, no es recomendable usar arch_prctl() y set_thread_area(2) en el mismo hilo, ya que pueden sobrescribirse mutuamente las entradas TLS. Es posible que la biblioteca de subprocesos ya este usando FS. Los programas que usan ARCH_SET_FS directamente tienen una alta probabilidad de fallar. VEASE TAMBIEN mmap(2), modify_ldt(2), prctl(2), set_thread_area(2) Manual del Programador de AMD X86-64 TRADUCCION La traduccion al espanol de esta pagina del manual fue creada por Miguel Perez Ibars y Marcos Fouces Esta traduccion es documentacion libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. Si encuentra algun error en la traduccion de esta pagina del manual, envie un correo electronico a . Paginas de Manual de Linux 6.15 17 Mayo 2025 arch_prctl(2)