The libdispatch Project, (a.k.a. Grand Central Dispatch), for concurrency on multicore hardware
C C++ Swift Objective-C M4 Objective-C++ Other
Latest commit d137aa4 Mar 17, 2017 @ktopley-apple ktopley-apple committed with ktopley-apple Makes the DispatchIO initializer that accepts a path failable, reflec…
…ting the fact that a relative or non-existent path is invalid.

(Radar 31115994)
Permalink
Failed to load latest commit information.
config Merge libdispatch-806 Feb 21, 2017
dispatch provide fallback definitions for all API_* macros Feb 22, 2017
libdispatch.xcodeproj merge darwin/libdispatch-806 Feb 21, 2017
libpwq @ 18437d2 update libpwq and libkqueue submodule versions Feb 21, 2017
m4 fix help string for --enable-embedded-blocks-runtime Aug 15, 2016
man Merge libdispatch-806 Feb 21, 2017
os Linux fixes for dispatch-806 merge Feb 22, 2017
private Merge libdispatch-806 Feb 21, 2017
resolver Import libdispatch-500.1.5 Nov 9, 2015
src Makes the DispatchIO initializer that accepts a path failable, reflec… Mar 20, 2017
tests Merge pull request #224 from dgrove-oss/epoll_support_dispatch_test Feb 26, 2017
tools Import libdispatch-500.1.5 Nov 9, 2015
xcodeconfig Merge libdispatch-806 Feb 21, 2017
xcodescripts Merge libdispatch-743 Feb 21, 2017
.gitignore xcode / autoconf plumbing to select module.modulemap file Aug 12, 2016
.gitmodules Merge libdispatch-743 Feb 21, 2017
CONTRIBUTING.md Add legal notice for pull requests and reference to contribution guid… Dec 5, 2015
INSTALL.md remove unused dependency on linux/membarrier.h for intel to fix CI build Feb 22, 2017
LICENSE Update to the Swift.org license Dec 18, 2015
Makefile.am Linux fixes for dispatch-806 merge Feb 22, 2017
PATCHES Merge pull request #214 from dgrove-oss/tweak-linux_base Feb 21, 2017
README.md SR-3237: Document libdispatch testsuite Nov 18, 2016
TESTING.md SR-3237: Document libdispatch testsuite Nov 18, 2016
autogen.sh Make autogen.sh executable Jun 7, 2016
configure.ac merge darwin/libdispatch-806 Feb 21, 2017

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 Goals

We are currently early in the development of this project. We began with a mirror of the open source drop that corresponds with OS X El Capitan (10.11) and have ported it to x86_64 Ubuntu 14.04 and 15.10. The next steps are:

  1. Complete the work to adopt libdispatch in other Core Libraries projects, especially Foundation. This will validate our work and get immediate test coverage on basic functionality of the Swift API.
  2. Include libdispatch and libdispatch-enabled Core Libraries in the Swift CI environment and the pre-built Swift toolchains at Swift.org.
  3. Develop a test suite for the Swift APIs of libdispatch.
  4. 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