void pthread_exit(void* value_ptr)
где
value_ptr
— указатель на результат выполнения потока.
При выполнении
pthread_exit()
поток завершается. Если этот поток принадлежит к категории ожидаемых, он может возвратить результат своей работы другому потоку, ожидающему его завершения на вызове
pthread_join()
(только один поток может получить результат завершения). Если же этот поток отсоединенный, то по его завершении все системные ресурсы, задействованные потоком, освобождаются немедленно.
Перед завершением потока будут выполнены все завершающие процедуры, помещенные в стек завершения, а также деструкторы собственных данных потока, о которых мы говорили ранее. Для последнего потока процесса вызов
pthread_exit()
эквивалентен
exit()
.
Возврат результата потока
Выше отмечено, что вызов
pthread_exit()
, завершающий ожидаемый поток, может передать результат выполнения потока. То же действие может быть выполнено и оператором
return
потоковой функции, которая из прототипа ее определения должна возвращать значение типа
void*
.
В обоих случаях результат может иметь сколь угодно сложный структурированный тип; никакая типизация результата не предусматривается (тип
void*
). Важно, чтобы код, ожидающий результата на вызове
pthread_join()
, понимал его так же, как и функция потока, возвращающая этот результат.
Другим условием является то, что переменная «результат» должна существовать к моменту вызова pthread_join(), то есть вполне возможно, что уже далеко после завершения самой функции ожидаемого потока. Этому условию не удовлетворяют, например, любые локальные для функции потока объекты, размещаемые в стеке. Приведем пример часто допускаемой ошибки. Следующая функция потока практически обречена на ошибку защиты памяти:
void* threadfunc(void* data) {
int res; // результат некоторых вычислений
res = ...
pthread_exit(&res);
}
А вот один из многих допустимых вариантов:
void* threadfunc(void* data) {
struct data *res = new struct; // результат некоторых вычислений
...
*res = ...
pthread_exit(res);
}
...
pthread_t tid;
pthread_create(&tid, NULL, threadfunc, NULL);
struct data *res;
pthread_join(tid, &res);
...
delete res;
Недостатком этого варианта является то, что память под блок данных результата выделяется в одной программной единице (в функции потока), а освобождаться должна в другой (в коде, ожидающем результата), при этом сами программные единицы могут размещаться даже в различных файлах исходного кода. (Здесь ситуация зеркально подобна ранее рассмотренному случаю передачи параметров в функцию создаваемого потока.)
Уничтожение (отмена) потока
Корректное завершение выполняющегося потока «извне», из другого потока (то есть асинхронно относительно прерываемого потока), — задача отнюдь не тривиальная; она намного сложнее аналогичной задачи прерывания процесса. Это связано с обсуждавшимся ранее при рассмотрении завершения потоков временем жизни объектов, которые могут быть использованы потоком к моменту его отмены (блоки динамической памяти, файловые дескрипторы, примитивы синхронизации и другие объекты системы).
Если для процесса в перечень «опасных» (с точки зрения завершения) объектов включаются только объекты со временем жизни выше уровня процесса (их число достаточно ограничено), то для потока в число таких объектов включаются уже все объекты со временем жизни процесса (process-persistent). Завершающийся (покидающий процесс) поток обязан оставить все объекты процесса в состоянии, пригодном для их дальнейшего использования другими потоками процесса.
Далее мы подробно рассмотрим то множество предосторожностей, которыми «обложена» отмена потока. Однако именно по причине их «множества» стоит сформулировать краткое правило: не пытайтесь завершать поток извне его функции потока, если для этого нет в высшей степени обоснованной необходимости (а такая необходимость действительно бывает, но крайне редко). Даже в крайнем случае следует рассмотреть возможность вместо отмены потока послать ему сигнал (даже не только «сигнал UNIX», а в более широком смысле — «некоторое сообщение»), который, обрабатываясь в контексте потока, после корректных завершающих действий вызовет его завершение. (Как обращаться с сигналами в потоке, будет детально рассмотрено позже.)
Для отмены (принудительного завершения) потока используется вызов:
int pthread_cancel(pthread_t thread);
где в качестве параметра thread указывается TID отменяемого потока. Однако этот вызов не отменяет поток, а только запрашивает завершение потока. В зависимости от статуса отмены, который мы сейчас рассмотрим, поток может перейти (или нет) к действию завершения, которое состоит в том, что:
• выполняются все процедуры завершения, занесенные ранее в стек завершения вызовами
pthread_cleanup_push()
;
• выполняются деструкторы собственных данных потока;
• отменяемый поток завершается;
• процесс отмены — асинхронный с точки зрения вызывающего
pthread_cancel()
кода, поэтому вызывающий отмену поток должен дождаться завершения потока на вызове
pthread_join()
.
Прежде всего, поток может вообще отказаться выполнять любые отмены, вызвав из своей функции потока:
int pthread_setcancelstate(int state, int* oldstate);
где
state
и
oldstate
— устанавливаемое и установленное ранее (возвращаемое вызовом) состояния отмены потока, которые могут принимать значения
PTHREAD_CANCEL_DISABLE
либо
PTHREAD_CANCEL_ENABLE
. (Естественно, как и во многих функциях с подобным прототипом, значением
oldstate
может быть
NULL
, и тогда нам не нужно возвращать ранее установленное состояние.)
Далее, даже если для потока установлено состояниезавершаемости (также называемое «состоянием отмены»)
PTHREAD_CANCEL_ENABLE
(это значение по умолчанию при создании потока), поток может переопределить еще и
типотмены, вызвав:
int pthread_setcanceltype(int type, int* oldtype);
где
type
и
oldtype
— как и в предыдущем случае, новое и ранее установленное значения типа отмены потока, которые могут принимать значения
PTHREAD_CANCEL_ASYNCHRONOUS
(асинхронный по отмене поток) либо
PTHREAD_CANCEL_DEFERRED
(синхронный по отмене поток). Значением по умолчанию, устанавливаемым при создании потока, является
PTHREAD_CANCEL_DEFERRED
, хотя предписываемым POSIX умолчанием является
PTHREAD
_CANCEL_ASYNCHRONOUS.
