From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 112792 invoked by alias); 1 Nov 2019 14:54:34 -0000 Mailing-List: contact glibc-cvs-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Archive: List-Post: List-Help: , Sender: glibc-cvs-owner@sourceware.org List-Subscribe: Received: (qmail 112774 invoked by uid 9943); 1 Nov 2019 14:54:34 -0000 Date: Fri, 01 Nov 2019 14:54:00 -0000 Message-ID: <20191101145434.112773.qmail@sourceware.org> Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: Adhemerval Zanella To: glibc-cvs@sourceware.org Subject: [glibc] manual: Add documentation for pthread_tryjoin_np and pthread_timedjoin_np X-Act-Checkin: glibc X-Git-Author: Mike Crowe X-Git-Refname: refs/heads/master X-Git-Oldrev: 22434b2f0360212d6c3ae775f425a0dbc97b2a4d X-Git-Newrev: 893bbdd0072fbf96808e66af04b970e5b39171fb X-SW-Source: 2019-q4/txt/msg00249.txt.bz2 https://sourceware.org/git/gitweb.cgi?p=glibc.git;h=893bbdd0072fbf96808e66af04b970e5b39171fb commit 893bbdd0072fbf96808e66af04b970e5b39171fb Author: Mike Crowe Date: Thu Oct 31 09:08:57 2019 -0300 manual: Add documentation for pthread_tryjoin_np and pthread_timedjoin_np Reviewed-by: Adhemerval Zanella Diff: --- manual/threads.texi | 26 ++++++++++++++++++++++++-- 1 file changed, 24 insertions(+), 2 deletions(-) diff --git a/manual/threads.texi b/manual/threads.texi index bfe1e5b..c0b504d 100644 --- a/manual/threads.texi +++ b/manual/threads.texi @@ -727,6 +727,30 @@ rather than @code{CLOCK_REALTIME}. Currently, @var{clockid} must be either returned. @end deftypefun +@comment pthread.h +@comment GNU extension +@deftypefun int pthread_tryjoin_np (pthread_t *@var{thread}, + void **@var{thread_return}) +@standards{GNU, pthread.h} +@safety{@prelim{}@mtsafe{}@asunsafe{@asulock{}}@acunsafe{@aculock{}}} +Behaves like @code{pthread_join} except that it will return @code{EBUSY} +immediately if the thread specified by @var{thread} has not yet terminated. +@end deftypefun + +@comment pthread.h +@comment GNU extension +@deftypefun int pthread_timedjoin_np (pthread_t *@var{thread}, + void **@var{thread_return}, + const struct timespec *@var{abstime}) +@standards{GNU, pthread.h} +@safety{@prelim{}@mtsafe{}@asunsafe{@asulock{}}@acunsafe{@aculock{}}} +Behaves like @code{pthread_tryjoin_np} except that it will block until the +absolute time @var{abstime} measured against @code{CLOCK_REALTIME} is +reached if the thread has not terminated by that time and return +@code{EBUSY}. If @var{abstime} is equal to @code{NULL} then the function +will wait forever in the same way as @code{pthread_join}. +@end deftypefun + @c FIXME these are undocumented: @c pthread_atfork @c pthread_attr_destroy @@ -844,6 +868,4 @@ returned. @c pthread_spin_trylock @c pthread_spin_unlock @c pthread_testcancel -@c pthread_timedjoin_np -@c pthread_tryjoin_np @c pthread_yield