.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) 2008 Linux Foundation, written by Michael Kerrisk
.\"     <mtk.manpages@gmail.com>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH pthread_tryjoin_np 3 "15 декабря 2022 г." "Linux man\-pages 6.03" 
.SH ИМЯ
pthread_tryjoin_np, pthread_timedjoin_np \- пытается присоединиться к
завершённой нити
.SH LIBRARY
POSIX threads library (\fIlibpthread\fP, \fI\-lpthread\fP)
.SH СИНТАКСИС
.nf
\fB#define _GNU_SOURCE\fP             /* Смотрите feature_test_macros(7) */
\fB#include <pthread.h>\fP
.PP
\fBint pthread_tryjoin_np(pthread_t \fP\fIthread\fP\fB, void **\fP\fIretval\fP\fB);\fP
\fBint pthread_timedjoin_np(pthread_t \fP\fIthread\fP\fB, void **\fP\fIretval\fP\fB,\fP
\fB                         const struct timespec *\fP\fIabstime\fP\fB);\fP
.fi
.SH ОПИСАНИЕ
Эти функции работают также как \fBpthread_join\fP(3) за исключением различий,
описанных в данной справочной странице.
.PP
Функция \fBpthread_tryjoin_np\fP() выполняет неблокирующую присоединение к нити
\fIthread\fP, возвращая в \fI*retval\fP код выхода нити. Если \fIthread\fP ещё не
завершилась, то вместо блокировки, как это делает \fBpthread_join\fP(3), вызов
возвращает ошибку.
.PP
The \fBpthread_timedjoin_np\fP()  function performs a join\-with\-timeout.  If
\fIthread\fP has not yet terminated, then the call blocks until a maximum time,
specified in \fIabstime\fP, measured against the \fBCLOCK_REALTIME\fP clock.  If
the timeout expires before \fIthread\fP terminates, the call returns an error.
The \fIabstime\fP argument is a \fBtimespec\fP(3)  structure, specifying an
absolute time measured since the Epoch (see \fBtime\fP(2)).
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
При успешном выполнении эти функции возвращают 0; при ошибке возвращается
номер ошибки.
.SH ОШИБКИ
Эти функции могут завершиться с теми же ошибками что и
\fBpthread_join\fP(3). Дополнительно, функция \fBpthread_tryjoin_np\fP() может
завершиться со следующей ошибкой:
.TP 
\fBEBUSY\fP
Нить \fIthread\fP не завершилась на момент вызова.
.PP
Дополнительно, функция \fBpthread_timedjoin_np\fP() может завершиться со
следующими ошибками:
.TP 
\fBEINVAL\fP
Некорректное значение \fIabstime\fP (\fItv_sec\fP меньше 0 или \fItv_nsec\fP больше
1e9).
.TP 
\fBETIMEDOUT\fP
Истёк период ожидания раньше завершения \fIthread\fP.
.PP
Функция \fBpthread_timedjoin_np\fP() никогда не возвращает ошибку \fBEINTR\fP.
.SH ВЕРСИИ
These functions were added in glibc 2.3.3.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.ad l
.nh
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
\fBpthread_tryjoin_np\fP(),
\fBpthread_timedjoin_np\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.hy
.ad
.sp 1
.SH СТАНДАРТЫ
Данные функции являются не стандартизированными расширениями GNU, о чём
свидетельствует наличие суффикса «_np» (nonportable).
.SH ДЕФЕКТЫ
The \fBpthread_timedjoin_np\fP()  function measures time by internally
calculating a relative sleep interval that is then measured against the
\fBCLOCK_MONOTONIC\fP clock instead of the \fBCLOCK_REALTIME\fP clock.
Consequently, the timeout is unaffected by discontinuous changes to the
\fBCLOCK_REALTIME\fP clock.
.SH ПРИМЕРЫ
Следующий код ждёт присоединения к нити не более 5 секунд:
.PP
.in +4n
.EX
struct timespec ts;
int s;

\&...

if (clock_gettime(CLOCK_REALTIME, &ts) == \-1) {
    /* обработка ошибки */
}

ts.tv_sec += 5;

s = pthread_timedjoin_np(thread, NULL, &ts);
if (s != 0) {
    /* обработка ошибки */
}
.EE
.in
.SH "СМ. ТАКЖЕ"
\fBclock_gettime\fP(2), \fBpthread_exit\fP(3), \fBpthread_join\fP(3), \fBtimespec\fP(3),
\fBpthreads\fP(7)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
Alexey,
Azamat Hackimov <azamat.hackimov@gmail.com>,
kogamatranslator49 <r.podarov@yandex.ru>,
Kogan,
Max Is <ismax799@gmail.com>,
Yuri Kozlov <yuray@komyakino.ru>
и
Иван Павлов <pavia00@gmail.com>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .