.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) 2008 Linux Foundation, written by Michael Kerrisk .\" .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH pthread_setcancelstate 3 "2 мая 2024 г." "Справочные страницы Linux 6.9.1" .SH ИМЯ pthread_setcancelstate, pthread_setcanceltype \- изменяет состояния и тип отменяемости .SH БИБЛИОТЕКА POSIX threads library (\fIlibpthread\fP, \fI\-lpthread\fP) .SH СИНТАКСИС .nf \fB#include \fP .P \fBint pthread_setcancelstate(int \fP\fIstate\fP\fB, int *\fP\fIoldstate\fP\fB);\fP \fBint pthread_setcanceltype(int \fP\fItype\fP\fB, int *\fP\fIoldtype\fP\fB);\fP .fi .SH ОПИСАНИЕ Функция \fBpthread_setcancelstate\fP() изменяет состояние отменяемости вызывающий нити на значение \fIstate\fP. Предыдущее состояние отменяемости нити возвращается в буфер, на который указывает \fIoldstate\fP. Аргументом \fIstate\fP должно быть одно из следующих значений: .TP \fBPTHREAD_CANCEL_ENABLE\fP The thread is cancelable. This is the default cancelability state in all new threads, including the initial thread. The thread's cancelability type determines when a cancelable thread will respond to a cancelation request. .TP \fBPTHREAD_CANCEL_DISABLE\fP The thread is not cancelable. If a cancelation request is received, it is blocked until cancelability is enabled. .P Функция \fBpthread_setcanceltype\fP() изменяет тип отменяемости вызывающий нити на значение \fItype\fP. Предыдущий тип отменяемости нити возвращается в буфер, на который указывает \fIoldstate\fP. Аргументом \fItype\fP должно быть одно из следующих значений: .TP \fBPTHREAD_CANCEL_DEFERRED\fP A cancelation request is deferred until the thread next calls a function that is a cancelation point (see \fBpthreads\fP(7)). This is the default cancelability type in all new threads, including the initial thread. .IP Even with deferred cancelation, a cancelation point in an asynchronous signal handler may still be acted upon and the effect is as if it was an asynchronous cancelation. .TP \fBPTHREAD_CANCEL_ASYNCHRONOUS\fP The thread can be canceled at any time. (Typically, it will be canceled immediately upon receiving a cancelation request, but the system doesn't guarantee this.) .P Операции установки и получения (set\-and\-get), выполняемые каждой из этих функций, являются атомарными для предотвращения пересечения с другими процессами, вызывающими ту же функцию. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" При успешном выполнении эти функции возвращают 0; при ошибке возвращается ненулевой номер ошибки. .SH ОШИБКИ Функция \fBpthread_setcancelstate\fP() может завершиться со следующей ошибкой: .TP \fBEINVAL\fP Неправильное значение для \fIstate\fP. .P Функция \fBpthread_setcanceltype\fP() может завершиться со следующей ошибкой: .TP \fBEINVAL\fP Неправильное значение для \fItype\fP. .SH АТРИБУТЫ Описание терминов данного раздела смотрите в \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Интерфейс Атрибут Значение T{ .na .nh \fBpthread_setcancelstate\fP(), \fBpthread_setcanceltype\fP() T} Безвредность в нитях T{ .na .nh MT\-Safe T} T{ .na .nh \fBpthread_setcancelstate\fP(), \fBpthread_setcanceltype\fP() T} Async\-cancel safety T{ .na .nh AC\-Safe T} .TE .SH СТАНДАРТЫ POSIX.1\-2008. .SH ИСТОРИЯ glibc 2.0 POSIX.1\-2001. .SH ПРИМЕЧАНИЯ For details of what happens when a thread is canceled, see \fB\%pthread_cancel\fP(3). .P Briefly disabling cancelability is useful if a thread performs some critical action that must not be interrupted by a cancelation request. Beware of disabling cancelability for long periods, or around operations that may block for long periods, since that will render the thread unresponsive to cancelation requests. .SS "Асинхронная отменяемость" Setting the cancelability type to \fBPTHREAD_CANCEL_ASYNCHRONOUS\fP is rarely useful. Since the thread could be canceled at \fIany\fP time, it cannot safely reserve resources (e.g., allocating memory with \fBmalloc\fP(3)), acquire mutexes, semaphores, or locks, and so on. Reserving resources is unsafe because the application has no way of knowing what the state of these resources is when the thread is canceled; that is, did cancelation occur before the resources were reserved, while they were reserved, or after they were released? Furthermore, some internal data structures (e.g., the linked list of free blocks managed by the \fBmalloc\fP(3) family of functions) may be left in an inconsistent state if cancelation occurs in the middle of the function call. Consequently, clean\-up handlers cease to be useful. .P Функции, которые можно безопасно асинхронно отменять называются \fIфункциями async\-cancel\-safe\fP. В POSIX.1\-2001 и POSIX.1\-2008 требуется, чтобы такими функция были только \fBpthread_cancel\fP(3), \fBpthread_setcancelstate\fP() и \fBpthread_setcanceltype\fP(). В общем, другие функции библиотеки нельзя безопасно вызывать из асинхронно отменяемой нити. .P One of the few circumstances in which asynchronous cancelability is useful is for cancelation of a thread that is in a pure compute\-bound loop. .SS "Замечания о переносимости" .\" It looks like at least Solaris, FreeBSD and Tru64 support this. Реализации нитей в Linux позволяют присваивать аргументу \fIoldstate\fP функции \fBpthread_setcancelstate\fP() значение NULL; в этом случае информация о предыдущем состоянии отмены не возвращается вызывающему. Многие другие реализации также допускают NULL в качестве значения \fIoldstat\fP, но POSIX.1 этот случай не рассматривается, поэтому переносимые приложения должны всегда указывать в \fIoldstate\fP значение, отличное от NULL. Эти утверждения относятся и к аргументу \fIoldtype\fP функции \fBpthread_setcanceltype\fP(). .SH ПРИМЕРЫ Смотрите \fBpthread_cancel\fP(3). .SH "СМОТРИТЕ ТАКЖЕ" \fBpthread_cancel\fP(3), \fBpthread_cleanup_push\fP(3), \fBpthread_testcancel\fP(3), \fBpthreads\fP(7) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства разработал(и) Alexey, Azamat Hackimov , kogamatranslator49 , Darima Kogan , Max Is , Yuri Kozlov и Иван Павлов . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT списка рассылки русских переводчиков .ME .