Scroll to navigation

ARCH_PRCTL(2) Руководство программиста Linux ARCH_PRCTL(2)

ИМЯ

arch_prctl - настроить состояние нити (зависит от архитектуры)

СИНТАКСИС

#include <asm/prctl.h>
#include <sys/prctl.h>
int arch_prctl(int code, unsigned long addr);
int arch_prctl(int code, unsigned long *addr);

ОПИСАНИЕ

Вызов arch_prctl() задаёт состояние процесса или нити, зависящие от архитектуры. В аргументе code задаётся подфункция и ей передаётся значение addr; параметр addr рассматривается либо как unsigned long при операциях «установки» (set), либо как unsigned long * при операциях «получения» (get).

Subfunctions for both x86 and x86-64 are:

Enable (addr != 0) or disable (addr == 0) the cpuid instruction for the calling thread. The instruction is enabled by default. If disabled, any execution of a cpuid instruction will instead generate a SIGSEGV signal. This feature can be used to emulate cpuid results that differ from what the underlying hardware would have produced (e.g., in a paravirtualization setting).
The ARCH_SET_CPUID setting is preserved across fork(2) and clone(2) but reset to the default (i.e., cpuid enabled) on execve(2).
Return the setting of the flag manipulated by ARCH_SET_CPUID as the result of the system call (1 for enabled, 0 for disabled). addr is ignored.
Установить 64-битную базу для регистра FS равной addr.
Return the 64-bit base value for the FS register of the calling thread in the unsigned long pointed to by addr.
Установить 64-битную базу для регистра GS равной addr.
Return the 64-bit base value for the GS register of the calling thread in the unsigned long pointed to by addr.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении arch_prctl() возвращает 0; при ошибке — -1, а в errno задаётся причина ошибки.

ОШИБКИ

В addr задан не выделенный адрес или вне адресного пространства процесса.
code не является допустимой подкомандой.
addr лежит вне адресного пространства процесса.
ARCH_SET_CPUID was requested, but the underlying hardware does not support CPUID faulting.

СООТВЕТСТВИЕ СТАНДАРТАМ

arch_prctl() является расширением Linux/x86-64 и не должна использоваться в переносимых программах.

ЗАМЕЧАНИЯ

В настоящее время arch_prctl() поддерживается только на Linux/x86-64 для 64-битных программ.

64-битная база изменяется при загрузке нового 32-битного сегментного селектора.

ARCH_SET_GS выключена в некоторых ядрах.

Переключение контекстов для 64-битных сегментных баз — довольно затратная операция. В качестве оптимизации, если используется 3-битные базовые адреса TLS, arch_prctl() может использовать реальную запись TLS, как при вызове set_thread_area(2), а не изменять сегментный базовый регистр напрямую. Память в первых 2 ГБ адресного пространства может быть выделена через mmap(2) с флагом MAP_32BIT.

Из-за вышеупомянутой оптимизации, использование arch_prctl() и set_thread_area(2) в той же нити опасно, так как они могут перезаписать TLS-записи друг друга.

В glibc версии 2.7 нет прототипа для arch_prctl(). Вам нужно объявлять его самостоятельно. Это может быть исправлено в новых версиях glibc.

FS уже может использоваться библиотекой нитей. Программы, в которых используется ARCH_SET_FS напрямую, весьма вероятно завершаться с ошибкой.

СМ. ТАКЖЕ

mmap(2), modify_ldt(2), prctl(2), set_thread_area(2)

Руководство программиста для AMD X86-64

ЗАМЕЧАНИЯ

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД

Русский перевод этой страницы руководства был сделан Dmitry Bolkhovskikh <d20052005@yandex.ru> и Yuri Kozlov <yuray@komyakino.ru>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.

11 апреля 2020 г. Linux