Project

General

Profile

Feature #1609

Bug #1577: User-level thread based OpenMP integration support on Mac

User-level thread implementation based on Boost context library

Added by Seonmyeong Bak 2 months ago. Updated 15 days ago.

Status:
Implemented
Priority:
Normal
Category:
SMP
Target version:
Start date:
06/14/2017
Due date:
% Done:

0%


Description

Currently, Converse has several user-level implementations.
1. QuickThread
2.Ucontext_t based
3. uJcontext(setjmp/longjmp based)
4. pthread based
5. stack copy

Ucontext_t is the default if it is available and uJcontext is used for Mac and Quickthread is used for ARM.
Ucontext_t is deprecated and has not been maintained by the Unix and Posix standard. The behavior of this sys calls is not defined on different environments.

For example, ucontext_t can allow migration of user-level context across threads in Linux but it doesn't allow the migration on Mac. (Different implementation)
uJcontext based on setjmp/longjmp cannot be used for this kind of migration. Setjmp/longjmp is designed for signal handling and nonlocal goto. So, the context should be resumed on the thread where the context is suspended previously.
Quickthread also doesn't show the same behavior on different environments as ucontext_t.

Now, Boost context is the only available user-level context for most of environments we are targeting.
1. Supported OS: WINDOWS, Mac, LINUX/UNIX, IOS
2. Supported Architecture: Details in the following link (most of architectures on each supported OS)
(http://www.boost.org/doc/libs/1_61_0/libs/context/doc/html/context/architectures.html)

The license of the boost library is similar to BSD and MIT license, which means we don't have liability to disclose our codes using Boost.

In addition, Boost provides assembly codes(machine executable object code) for this context implementation. (Don't need to compile their codes. We can use their implementation only with these assembly codes)
(http://www.boost.org/users/license.html)

Argobot also adopts fcontext_t and using assembly codes for their user-level threads.

History

#1 Updated by Seonmyeong Bak 2 months ago

  • Category set to SMP

#2 Updated by Seonmyeong Bak 15 days ago

  • Status changed from New to Implemented

#4 Updated by Seonmyeong Bak 15 days ago

Currently, I implemented uFcontext using assembly codes from boost context library.
And changed the build script to choose appropriate assembly source codes depending on the build target of Charm++.

Boost context assembly codes support PPC, ARM, MIPS and x86_64 on linux, Mac OS X and Windows.

This assembly codes doesn't include the support of Windows. This will be added in a separate patch.

#5 Updated by Seonmyeong Bak 15 days ago

With this library, the OpenMP integration works well on MacOSX with GCC and barrier related directives also works on Linux and Mac OS X.

Boost context doesn't guarantee thread-local variables so I turned off TLS based Cpv variable option (CMK_NOT_USE_TLS_THREAD 1)

#6 Updated by Sam White 15 days ago

  • Target version set to 6.9.0

Also available in: Atom PDF