table of contents
set_tid_address(2) | System Calls Manual | set_tid_address(2) |
ИМЯ¶
set_tid_address - устанавливает указатель идентификатора нити
LIBRARY¶
Standard C library (libc, -lc)
СИНТАКСИС¶
#include <sys/syscall.h> /* определения констант SYS_* */ #include <unistd.h>
pid_t syscall(SYS_set_tid_address, int *tidptr);
Note: glibc provides no wrapper for set_tid_address(), necessitating the use of syscall(2).
ОПИСАНИЕ¶
В ядре для каждой нити хранится два атрибута (адреса): set_child_tid и clear_child_tid. Их значение по умолчанию равно NULL.
- set_child_tid
- Если нить запущена с помощью clone(2) с флагом CLONE_CHILD_SETTID, то значение set_child_tid устанавливается равным аргументу системного вызова ctid.
- Если set_child_tid присвоено значение, то самое первое действие, которое выполняется для новой нити, это запись ID нити по этому адресу.
- clear_child_tid
- Если нить запущена с помощью clone(2) с флагом CLONE_CHILD_CLEARTID, то значение clear_child_tid устанавливается равным аргументу системного вызова ctid.
Системный вызов set_tid_address() устанавливает у вызывающей нити значение clear_child_tid равным tidptr.
Если нить, чьё значение clear_child_tid не равно NULL, завершается и если нить использовала общую память с другими нитями, то по адресу, указанному в clear_child_tid, записывается 0 и ядро выполняет следующую операцию:
futex(clear_child_tid, FUTEX_WAKE, 1, NULL, NULL, 0);
Действие этой операции в том, что она пробуждает единственную нить, выполнявшую ожидание futex на расположение памяти. Ошибки операции пробуждения futex игнорируются.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
Вызов set_tid_address() всегда возвращает ID вызывающей нити.
ОШИБКИ¶
Вызов set_tid_address() всегда завершается без ошибок.
СТАНДАРТЫ¶
Linux.
ИСТОРИЯ¶
Linux 2.5.48.
Details as given here are valid since Linux 2.5.49.
СМОТРИТЕ ТАКЖЕ¶
ПЕРЕВОД¶
Русский перевод этой страницы руководства разработал Alexander Golubev <fatzer2@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Hotellook, Nikita <zxcvbnm3230@mail.ru>, Spiros Georgaras <sng@hellug.gr>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>
Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику по его адресу электронной почты или по адресу списка рассылки русских переводчиков.
2 мая 2024 г. | Linux man-pages (unreleased) |