### Dispatch_Samples ###

===========================================================================

DESCRIPTION:

Sample code showing how to: monitor process, do file and network I/O,

create and manage timers, and use dispatch_apply

===========================================================================

BUILD REQUIREMENTS:

Mac OS X version 10.6 Snow Leopard

===========================================================================

RUNTIME REQUIREMENTS:

Mac OS X version 10.6 Snow Leopard

===========================================================================

PACKAGING LIST:

apply.c       - dispatch_apply examples

netcat.c      - network I/O examples

nWide.c       - use of dispatch_semaphore to limit number of in-flight blocks

proc.c        - process monitoring example

readFile.c    - file I/O examples

readFileF.c   - file I/O examples without Blocks

timers.c      - create and manage timers

===========================================================================

SAMPLE USAGE:

dispatch-apply

dispatch-apply takes no arguments.   When run it will display some status

messages and timing information.

dispatch-netcat

Open two terminal windows.   In one window run the "server":

cat ReadMe.txt | dispatch-netcat -l localhost 5050

In the other run the "client":

dispatch-netcat localhost 5050

Your server will send the contents of ReadMe.txt to the client, the server

will close its connection and exit.   The client will display whatever

the server sent (the ReadMe.txt file).   See the main function in netcat.c

for more options.

dispatch-nWide

dispatch-nWide takes no arguments.   When run it will display explanatory

text.

dispatch-proc

dispatch-proc takes no arguments.   When run it will display output from

some processes it runs, and it will display information from the

process lifecycle events dispatch generates.

dispatch-readFile

Run dispatch-readFile with a filename as an argument:

dispatch-readFile ReadMe.txt

It will read the file 10 (or fewer) bytes at a time and display how many

bytes dispatch thinks are remaining to read.

dispatch-readFileF

Exactly the same as dispatch-readFile, but written without the use of Blocks.

dispatch-timers

dispatch-timers takes no arguments, running it display timer ticks for

a timer with an initial interval of one second, changing to one half second 

after the first three events.   It will exit after six events.

===========================================================================

CHANGES FROM PREVIOUS VERSIONS:

Version 1.1

- Updated to current libdispatch API, and added samples readFileF.c and 

nWide.c

Version 1.0

- First version

===========================================================================

Copyright (C) 2009 Apple Inc. All rights reserved.