diff options
author | Jerry Jelinek <jerry.jelinek@joyent.com> | 2016-05-20 11:11:36 +0000 |
---|---|---|
committer | Jerry Jelinek <jerry.jelinek@joyent.com> | 2016-05-20 11:11:36 +0000 |
commit | b22cc2b5e082fb850f02e032a81cf11561262b95 (patch) | |
tree | 2ac128535e6eff2fa208c6b703dfb5282ddefa3c /usr/src/man/man3c/thrd_join.3c | |
parent | dea7bb8f6a5a7494442b7d496b73ccf6995cd15c (diff) | |
parent | 7dc9a163b382daee1ce43b6588dd1b507363dae5 (diff) | |
download | illumos-joyent-b22cc2b5e082fb850f02e032a81cf11561262b95.tar.gz |
[illumos-gate merge]
commit 7dc9a163b382daee1ce43b6588dd1b507363dae5
6790 want suite of endian(3C) functions
commit e56998eefc33ead0f12b364be915dd6bfc12a3f5
6501 Implement pthread_attr_get_np() interface
commit fc2512cfb727d49529d8ed99164db871f4829b73
6951 Initial c11 support
6952 gets should not be visible in C11
6953 add support for c11 threads api
6954 Symbols test should support validating pre-processor symbols
commit ea4a67f462de0a39a9adea8197bcdef849de5371
6980 6902 causes zfs send to break due to 32-bit/64-bit struct mismatch
Conflicts:
usr/src/test/libc-tests/tests/Makefile
usr/src/test/libc-tests/runfiles/default.run
usr/src/lib/libcmdutils/libcmdutils.h
usr/src/lib/libcmdutils/common/custr.c
usr/src/lib/libcmdutils/common/mapfile-vers
Diffstat (limited to 'usr/src/man/man3c/thrd_join.3c')
-rw-r--r-- | usr/src/man/man3c/thrd_join.3c | 81 |
1 files changed, 81 insertions, 0 deletions
diff --git a/usr/src/man/man3c/thrd_join.3c b/usr/src/man/man3c/thrd_join.3c new file mode 100644 index 0000000000..d2cb8c83ea --- /dev/null +++ b/usr/src/man/man3c/thrd_join.3c @@ -0,0 +1,81 @@ +.\" +.\" This file and its contents are supplied under the terms of the +.\" Common Development and Distribution License ("CDDL"), version 1.0. +.\" You may only use this file in accordance with the terms of version +.\" 1.0 of the CDDL. +.\" +.\" A full copy of the text of the CDDL should have accompanied this +.\" source. A copy of the CDDL is also available via the Internet at +.\" http://www.illumos.org/license/CDDL. +.\" +.\" +.\" Copyright 2016 Joyent, Inc. +.\" +.Dd "Jan 13, 2015" +.Dt THRD_JOIN 3C +.Os +.Sh NAME +.Nm thrd_join +.Nd wait for thread termination +.Sh SYNOPSIS +.In threads.h +.Ft int +.Fo thrd_join +.Fa "thrd_t thrd" +.Fa "int *res" +.Fc +.Sh DESCRIPTION +The +.Fn thrd_join +function suspends the exection of the current thread and waits for the +thread indicated by +.Fa thrd +to terminate and stores the exit status, as set by a call to +.Xr thrd_exit 3C , +for that thread in +.Fa res , +if +.Fa res +is non-null. The +.Fa thrd +argument must be a member of the current process and it cannot be +detached. If +.Fa thrd +has already terminated and another caller has not called +.Fn thrd_join +then the exit status will be returned to the caller without blocking +execution of the thread. +.Pp +If multiple threads call +.Fn thrd_join +on the same thread, then both will be suspended until that thread +terminates; however, only one thread will return successfully and obtain +the actual status and the other will instead return with an error. +.Pp +For additional information on the thread joining interfaces supported by +the system, see +.Xr pthread_join 3C +and +.Xr thr_join 3C . +.Sh RETURN_VALUES +Upon successful completion, the +.Fn thrd_join +function returns +.Sy thrd_success +and if +.Fa res +is a non-null pointer, it will be filled in with the exit status of +.Xr thrd . +If an error occurs, +.Sy thrd_error +will be returned. +.Sh INTERFACE STABILITY +.Sy Standard +.Sh MT-LEVEL +.Sy MT-Safe +.Sh SEE ALSO +.Xr pthread_join 3C , +.Xr thrd_create 3C , +.Xr thrd_detach 3C , +.Xr attributes 5 , +.Xr threads 5 |