summaryrefslogtreecommitdiff
path: root/usr/src/man/man3c/thrd_join.3c
diff options
context:
space:
mode:
authorJerry Jelinek <jerry.jelinek@joyent.com>2016-05-20 11:11:36 +0000
committerJerry Jelinek <jerry.jelinek@joyent.com>2016-05-20 11:11:36 +0000
commitb22cc2b5e082fb850f02e032a81cf11561262b95 (patch)
tree2ac128535e6eff2fa208c6b703dfb5282ddefa3c /usr/src/man/man3c/thrd_join.3c
parentdea7bb8f6a5a7494442b7d496b73ccf6995cd15c (diff)
parent7dc9a163b382daee1ce43b6588dd1b507363dae5 (diff)
downloadillumos-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.3c81
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