git.saurik.com Git - apple/libdispatch.git/blame_incremental

0 / 94 ( 0%)

Commit	Line	Data
	1	Grand Central Dispatch (GCD)
	2
	3	GCD is a concurrent programming framework first shipped with Mac OS X Snow
	4	Leopard. This package is an open source bundling of libdispatch, the core
	5	user space library implementing GCD. At the time of writing, support for
	6	the BSD kqueue API, and specifically extensions introduced in Mac OS X Snow
	7	Leopard and FreeBSD 9-CURRENT, are required to use libdispatch. Other
	8	systems are currently unsupported.
	9
	10	Configuring and installing libdispatch
	11
	12	GCD is built using autoconf, automake, and libtool, and has a number of
	13	compile-time configuration options that should be reviewed before starting.
	14	An uncustomized install requires:
	15
	16	sh autogen.sh
	17	./configure
	18	make
	19	make install
	20
	21	The following configure options may be of general interest:
	22
	23	--with-apple-libc-source
	24
	25	Specify the path to Apple's Libc package, so that appropriate headers can
	26	be found and used.
	27
	28	--with-apple-libclosure-source
	29
	30	Specify the path to Apple's Libclosure package, so that appropriate headers
	31	can be found and used.
	32
	33	--with-apple-xnu-source
	34
	35	Specify the path to Apple's XNU package, so that appropriate headers can be
	36	found and used.
	37
	38	--with-blocks-runtime
	39
	40	On systems where -fblocks is supported, specify an additional library path
	41	in which libBlocksRuntime can be found. This is not required on Mac OS X,
	42	where the Blocks runtime is included in libSystem, but is required on
	43	FreeBSD.
	44
	45	The following options are likely to only be useful when building libdispatch on
	46	Mac OS X as a replacement for /usr/lib/system/libdispatch.dylib:
	47
	48	--with-apple-objc4-source
	49
	50	Specify the path to Apple's objc4 package, so that appropriate headers can
	51	be found and used.
	52
	53	--with-apple-libauto-source
	54
	55	Specify the path to Apple's libauto package, so that appropriate headers
	56	can be found and used.
	57
	58	--disable-libdispatch-init-constructor
	59
	60	Do not tag libdispatch's init routine as __constructor, in which case it
	61	must be run manually before libdispatch routines can be called. This is the
	62	default when building on Mac OS X. For /usr/lib/system/libdispatch.dylib
	63	the init routine is called automatically during process start.
	64
	65	--enable-apple-tsd-optimizations
	66
	67	Use a non-portable allocation scheme for pthread per-thread data (TSD) keys
	68	when building libdispatch for /usr/lib/system on Mac OS X. This should not
	69	be used on other OS's, or on Mac OS X when building a stand-alone library.
	70
	71	Typical configuration commands
	72
	73	The following command lines create the configuration required to build
	74	libdispatch for /usr/lib/system on OS X MountainLion:
	75
	76	sh autogen.sh
	77	cflags='-arch x86_64 -arch i386 -g -Os'
	78	./configure CFLAGS="$cflags" OBJCFLAGS="$cflags" CXXFLAGS="$cflags" \
	79	--prefix=/usr --libdir=/usr/lib/system \
	80	--disable-dependency-tracking --disable-static \
	81	--enable-apple-tsd-optimizations \
	82	--with-apple-libc-source=/path/to/10.8.0/Libc-825.24 \
	83	--with-apple-libclosure-source=/path/to/10.8.0/libclosure-59 \
	84	--with-apple-xnu-source=/path/to/10.8.0/xnu-2050.7.9 \
	85	--with-apple-objc4-source=/path/to/10.8.0/objc4-532 \
	86	--with-apple-libauto-source=/path/to/10.8.0/libauto-185.1
	87	make check
	88
	89	Typical configuration line for FreeBSD 8.x and 9.x to build libdispatch with
	90	clang and blocks support:
	91
	92	sh autogen.sh
	93	./configure CC=clang --with-blocks-runtime=/usr/local/lib
	94	make check