commit | cffa6f01adcc95db5bc21555ac73cd7f75a4c82a | [log] [tgz] |
---|---|---|
author | Aaron Dierking <aarond@fb.com> | Thu Jul 05 15:49:57 2018 -0700 |
committer | Aaron Dierking <aarond@fb.com> | Thu Jul 05 16:02:31 2018 -0700 |
tree | 2ac848aed04ca14ec30c126374d465df4c6dbb28 | |
parent | ba3933dcec4a85ee95bd12f812e0af15c678ef02 [diff] |
build: support embedding in other CMake projects Allow libdispatch to be embedded in other CMake projects using add_subdirectory(). This essentially means that `CMAKE_SOURCE_DIR` and `CMAKE_BINARY_DIR` cannot be used directly. Use the versions of these variables which are scoped to the current project or directory.
Grand Central Dispatch (GCD or libdispatch) provides comprehensive support for concurrent code execution on multicore hardware.
libdispatch is currently available on all Darwin platforms. This project aims to make a modern version of libdispatch available on all other Swift platforms. To do this, we will implement as much of the portable subset of the API as possible, using the existing open source C implementation.
libdispatch on Darwin is a combination of logic in the xnu
kernel alongside the user-space Library. The kernel has the most information available to balance workload across the entire system. As a first step, however, we believe it is useful to bring up the basic functionality of the library using user-space pthread primitives on Linux. Eventually, a Linux kernel module could be developed to support more informed thread scheduling.
A port of libdispatch to Linux has been completed. On Linux, since Swift 3, swift-corelibs-libdispatch has been included in all Swift releases and is used by other swift-corelibs projects.
Opportunities to contribute and on-going work include:
For detailed instructions on building and installing libdispatch, see INSTALL.md
For detailed instructions on testing libdispatch, see TESTING.md