[apple/libdispatch.git] / man / dispatch.3

.\" Copyright (c) 2008-2009 Apple Inc. All rights reserved.
.Dd May 1, 2009
.Dt dispatch 3
.Os Darwin
.Sh NAME
.Nm dispatch
.Nd the dispatch framework
.Sh SYNOPSIS
.Fd #include <dispatch/dispatch.h>
.Sh DESCRIPTION
The dispatch framework allows blocks to be scheduled for asynchronous and
concurrent execution via the core functions described in
.Xr dispatch_async 3 and
.Xr dispatch_apply 3 .
.Pp
Dispatch queues are the basic units of organization of blocks. Several queues
are created by default, and applications may create additional queues for their
own use. See
.Xr dispatch_queue_create 3
for more information.
.Pp
Dispatch groups allow applications to track the progress of blocks submitted to
queues and take action when the blocks complete. See
.Xr dispatch_group_create 3
for more information.
.Pp
The dispatch framework also provides functions to monitor underlying system
events and automatically submit event handler blocks to dispatch queues.
.Sh SEE ALSO
.Xr dispatch_async 3 ,
.Xr dispatch_object 3 ,
.Xr dispatch_queue_create 3 ,
.Xr dispatch_group_create 3 ,
.Xr dispatch_source_create 3 ,
.Xr dispatch_benchmark 3 ,
.Xr dispatch_time 3 ,
.Xr dispatch_apply 3 ,
.Xr dispatch_once 3 .
Commit	Line	Data
0ab74447 A	1	.\" Copyright (c) 2008-2009 Apple Inc. All rights reserved.
	2	.Dd May 1, 2009
	3	.Dt dispatch 3
	4	.Os Darwin
	5	.Sh NAME
	6	.Nm dispatch
	7	.Nd the dispatch framework
	8	.Sh SYNOPSIS
	9	.Fd #include <dispatch/dispatch.h>
	10	.Sh DESCRIPTION
	11	The dispatch framework allows blocks to be scheduled for asynchronous and
	12	concurrent execution via the core functions described in
	13	.Xr dispatch_async 3 and
	14	.Xr dispatch_apply 3 .
	15	.Pp
	16	Dispatch queues are the basic units of organization of blocks. Several queues
	17	are created by default, and applications may create additional queues for their
	18	own use. See
	19	.Xr dispatch_queue_create 3
	20	for more information.
	21	.Pp
	22	Dispatch groups allow applications to track the progress of blocks submitted to
	23	queues and take action when the blocks complete. See
	24	.Xr dispatch_group_create 3
	25	for more information.
	26	.Pp
	27	The dispatch framework also provides functions to monitor underlying system
	28	events and automatically submit event handler blocks to dispatch queues.
	29	.Sh SEE ALSO
	30	.Xr dispatch_async 3 ,
	31	.Xr dispatch_object 3 ,
	32	.Xr dispatch_queue_create 3 ,
	33	.Xr dispatch_group_create 3 ,
	34	.Xr dispatch_source_create 3 ,
	35	.Xr dispatch_benchmark 3 ,
	36	.Xr dispatch_time 3 ,
	37	.Xr dispatch_apply 3 ,
	38	.Xr dispatch_once 3 .