Google Git
Sign in
fuchsia / third_party / swift-corelibs-libdispatch / e013bea20d9958e60aace9eef4bf472251e349ab
commite013bea20d9958e60aace9eef4bf472251e349ab[log] [tgz]
authorSaleem Abdulrasool <compnerd@compnerd.org>Fri Feb 16 13:11:47 2018 -0800
committerSaleem Abdulrasool <compnerd@compnerd.org>Sun Mar 18 17:07:53 2018 -0700
tree800e74cebeb8284b35cf7f4791ea2672be5d61f5
parent79ca48baf44306c2cec327604855d93fa61347eb [diff]
revive the Windows port

The `DISPATCH_EXPORT` macro added an extraneous `extern` on the
declaration.  This was pointed out by a newer clang.  Adjust the
declaration accordingly.

Add build rules to improve Windows builds.  These additions help
cross-compile to Windows with both clang-cl as well as the GNU clang
driver.

Use the newer Windows APIs to detect the windows CPU state.  This allows
us to collect all of the CPU configuration information to properly
affinitise work to the preferred CPU.

Use the FLS API to create thread local data storage for libdispatch's
queues.
37 files changed
tree: 800e74cebeb8284b35cf7f4791ea2672be5d61f5
  1. cmake/
  2. dispatch/
  3. libdispatch.xcodeproj/
  4. man/
  5. os/
  6. private/
  7. resolver/
  8. src/
  9. tests/
  10. tools/
  11. xcodeconfig/
  12. xcodescripts/
  13. .gitignore
  14. .gitmodules
  15. CMakeLists.txt
  16. CONTRIBUTING.md
  17. INSTALL.md
  18. LICENSE
  19. PATCHES
  20. README.md
  21. TESTING.md
README.md

Grand Central Dispatch

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.

Project Status

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:

  1. Develop a test suite for the Swift APIs of libdispatch.
  2. Enhance libdispatch as needed to support Swift language evolution and the needs of the other Core Libraries projects.

Build and Install

For detailed instructions on building and installing libdispatch, see INSTALL.md

Testing

For detailed instructions on testing libdispatch, see TESTING.md