Commit Graph

8 Commits

Author SHA1 Message Date
Pedro F. Giffuni
b6413b6db8 POSIX compliance improvements in the pthread(3) functions.
This basically adds makes use of the C99 restrict keyword, and also
adds some 'const's to four threading functions: pthread_mutexattr_gettype(),
pthread_mutexattr_getprioceiling(), pthread_mutexattr_getprotocol(), and
pthread_mutex_getprioceiling. The changes are in accordance to POSIX/SUSv4-2018.

Hinted by:	DragonFlyBSD

Relnotes:	yes
MFC after:	1 month
Differential Revision:	D16722
2018-08-18 01:05:38 +00:00
Konstantin Belousov
2a339d9e3d Add implementation of robust mutexes, hopefully close enough to the
intention of the POSIX IEEE Std 1003.1TM-2008/Cor 1-2013.

A robust mutex is guaranteed to be cleared by the system upon either
thread or process owner termination while the mutex is held.  The next
mutex locker is then notified about inconsistent mutex state and can
execute (or abandon) corrective actions.

The patch mostly consists of small changes here and there, adding
neccessary checks for the inconsistent and abandoned conditions into
existing paths.  Additionally, the thread exit handler was extended to
iterate over the userspace-maintained list of owned robust mutexes,
unlocking and marking as terminated each of them.

The list of owned robust mutexes cannot be maintained atomically
synchronous with the mutex lock state (it is possible in kernel, but
is too expensive).  Instead, for the duration of lock or unlock
operation, the current mutex is remembered in a special slot that is
also checked by the kernel at thread termination.

Kernel must be aware about the per-thread location of the heads of
robust mutex lists and the current active mutex slot.  When a thread
touches a robust mutex for the first time, a new umtx op syscall is
issued which informs about location of lists heads.

The umtx sleep queues for PP and PI mutexes are split between
non-robust and robust.

Somewhat unrelated changes in the patch:
1. Style.
2. The fix for proper tdfind() call use in umtxq_sleep_pi() for shared
   pi mutexes.
3. Removal of the userspace struct pthread_mutex m_owner field.
4. The sysctl kern.ipc.umtx_vnode_persistent is added, which controls
   the lifetime of the shared mutex associated with a vnode' page.

Reviewed by:	jilles (previous version, supposedly the objection was fixed)
Discussed with:	brooks, Martin Simmons <martin@lispworks.com> (some aspects)
Tested by:	pho
Sponsored by:	The FreeBSD Foundation
2016-05-17 09:56:22 +00:00
Ruslan Ermilov
3e9ed1efb8 Hide the implementation details about multiple threading libraries
from the synopses of pthread*(3) manpages.

Reviewed by:	deischen, davidxu
2007-10-22 10:08:01 +00:00
Ruslan Ermilov
95e055a2cf Removed the IMPLEMENTATION NOTES section made redundant by not
putting libc_r into the LIBRARY section.
2004-01-15 16:13:49 +00:00
Ruslan Ermilov
f9f9d2e804 Document interfaces that are supported by libthr. 2004-01-15 15:59:00 +00:00
Ruslan Ermilov
5360187e7a Spell POSIX threads library as "libpthread", mdoc(7) is smart
enough to render it as "-lkse" these days.
2004-01-14 21:53:19 +00:00
Ruslan Ermilov
fac93adb3d This interface is not provided by libc_r. It is, on the other
hand, is also provided by libthr, but this will be addressed
later.
2004-01-14 21:12:39 +00:00
Mike Makonnen
ec2456e2c2 Aargh, cvs add pthread_mutex_timedlock 2003-12-30 08:50:04 +00:00