Главная » 2017 » Ноябрь » 24 » man 2 set_thread_area
05:19
man 2 set_thread_area

SEO sprint - Всё для максимальной раскрутки!





ИМЯ


get_thread_area, set_thread_area - назначение элемента GDT для области локального хранилища
нити



ОБЗОР


#include <linux/unistd.h>
#include <asm/ldt.h>

int get_thread_area(struct user_desc *u_info);
int set_thread_area(struct user_desc *u_info);

Замечание: В glibc нет обёрточных функций для этих системных вызовов; смотрите ЗАМЕЧАНИЯ.



ОПИСАНИЕ


В Linux под локальное хранилище нити отдано три элемента глобальной таблицы дескрипторов
(GDT). Подробней о GDT читайте в Intel Software Developer's Manual или AMD Architecture
Programming Manual.

Этим системным вызовам передаётся указатель на структуру вида:

struct user_desc {
unsigned int entry_number;
unsigned long base_addr;
unsigned int limit;
unsigned int seg_32bit:1;
unsigned int contents:2;
unsigned int read_exec_only:1;
unsigned int limit_in_pages:1;
unsigned int seg_not_present:1;
unsigned int useable:1;
};

Вызов get_thread_area() читает элемент GDT, указанный в u_info->entry_number и заполняет
оставшиеся поля в u_info.

Вызов set_thread_area() изменяет элемент TLS в GDT.

Элемент массива TLS, устанавливаемый set_thread_area(), соответствует значению
u_info->entry_number, которое передал пользователь. Если это значение находится в допустимых
пределах, то set_thread_area() записывает дескриптор TLS, на который указывает u_info, в
массив TLS нити.

Когда set_thread_area() передаётся entry_number со значением -1, то ищется свободный элемент
TLS. Если set_thread_area() находит свободный элемент TLS, то значение u_info->entry_number
устанавливается после возврата для показа того, какой же элемент был изменён.

Структура user_desc считается «пустой», если read_exec_only и seg_not_present равны 1, а все
остальные поля равны 0. Если «пустой» дескриптор передаётся в set_thread_area, то
соответствующий элемент TLS будет очищен. Дополнительную информацию смотрите в разделе
ДЕФЕКТЫ.

Начиная с Linux 3.19, set_thread_area() нельзя использовать для записи отсутствующих
сегментов, 16-битных сегментов или сегментов кода, но допускается очистка таких сегментов.



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


Данные системные вызовы возвращают 0 при успешном выполнении и 1 при ошибке, записывая в
errno соответствующее значение.
ESRCH (set_thread_area()) Невозможно найти свободный элемент TLS.



ВЕРСИИ


Вызов set_thread_area() появился в версии 2.5.29. Вызов get_thread_area() появился в Linux
2.5.32.



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


set_thread_area() есть только в Linux, и он не должен использоваться в переносимых
программах.



ЗАМЕЧАНИЯ


В glibc нет обёрточных функций для этих системных вызовов, так как они предназначены только
для использования в библиотеках нитей. Если вам всё-таки нужно их вызвать, используйте
syscall(2).

Вызов arch_prctl(2) может влиять на set_thread_area(). Подробней смотрите в arch_prctl(2).
Обычно это не вызывает проблем, так как arch_prctl(2) обычно используется только в 64-битных
программах.



ДЕФЕКТЫ


В 64-битных ядрах до Linux 3.19, если был установлен один из битов заполнения в user_desc,
то это приводило к тому, что дескриптор не считался пустым (смотрите modify_ldt(2)). В
результате, единственным надёжным способом очистить элемент TLS было задействование
memset(3) для обнуления всей структуры user_desc, включая биты заполнения, и затем установка
битов read_exec_only и seg_not_present. В Linux 3.19, структура user_desc, полностью
состоящая из нулей кроме entry_number, также будет считаться запросом на очистку элемента
TLS, что отличается от работы старых ядер.

До Linux 3.19, сегментные регистры DS и ES не должны ссылаться на элементы TLS.



СМОТРИТЕ ТАКЖЕ


arch_prctl(2), modify_ldt(2)



Категория: (2) Системные вызовы ядра (функции языка Си) | Просмотров: 25 | Добавил: Администратор | Рейтинг: 0.0/0
Всего комментариев: 0
avatar