Tree [r113] /
History



File Date Author Commit
cmake.modules 2014-01-27 massimot [r82] first commit of the newer 2.0.3 version
docs 2012-12-08 massimot [r52] added 2 new papers:
doxygen 2013-04-13 massimot [r61] release major update
examples 2014-04-08 massimot [r111] - fixed compilation problem with the Barrier
experimental 2013-09-08 massimot [r63] First check in of the 2.0.2 release. Main changes:
ff 2014-04-08 massimot [r111] - fixed compilation problem with the Barrier
tests 6 days ago massimot [r113] minor changes to test_multi_input8
AUTHORS 2013-11-10 massimot [r68] - general enhancement (tested only for Linux at...
BUILD.ME 2013-12-28 aldinuc [r76] Windows cmake instruction fixed
CMakeLists.txt 2013-12-28 aldinuc [r77] Fixes ro compile C++11 code under MSVC10
COPYING 2009-10-15 massimot [r1] new import
COPYING.LESSER 2010-03-22 massimot [r11] moved to LGPLv3
Changelog.txt 2014-04-08 massimot [r111] - fixed compilation problem with the Barrier
FAQ.txt 2013-04-09 massimot [r58] update to release 2.0.1
README 2013-04-09 massimot [r58] update to release 2.0.1
TODO 2014-03-21 massimot [r102] - many changes, among these:
cmake_uninstall.cmake.in 2010-08-28 massimot [r19] First commit of the new 1.0.0 version.

Read Me

FastFlow
^^^^^^^^

FastFlow is a multi-cores programming framework implemented as a C++ template 
library that offers a set of mechanisms to support low-latency and 
high-bandwidth data flows in a network of threads running on
a cache-coherent multi-core architectures. On these architectures, one of the 
key performance issues concern memory fences, which are required to keep the 
various caches coherent. 
FastFlow provides the programmer with two basic mechanisms:
  1. efficient point-to-pint communication channels;
  2. a memory allocator.

Communication channels, as typical is in streaming applications, are 
unidirectional and asynchronous. They are implemented via fence-free FIFO
queues. The memory allocator is built on top of these queues, thus taking 
advantage of their efficiency.
On top of these basic machnisms FastFlow provides a library of explicitly 
parallel constructs (a.k.a. skeletons) such as pipeline and farm.
The farm skeleton, exploits functional replication and abstracts the 
parallel filtering of successive independent items of the stream under the 
control of a scheduler.


-----------------

See the BUILD.ME file for instructions about Cmake builds and testing.

See tests directory for some simple runnable examples.

-----------------

FastFlow has been tested on:
 Linux with gcc (> 4.0.1): i386, x86_64
 Mac OS (>= 10.4) with gcc (> 4.0.1): x86_64, PowerPC G4, PowerPC G5
 Windows XP 32bit with Visual Studio 9 2008 Win32: i386, x86_64 
 Windows 7  64bit with Visual Studio 9 2008 Win32: x86_64 
 Windows 7  64bit with Visual Studio 9 2008 Win64: x86_64 
 Windows 7  64bit with Visual Studio 10 2010 Win32:  x86_64 
 Windows 7  64bit with Visual Studio 10 2010 Win64:  x86_64
 Windows with cygwin: not yet tested

Main development platform are Linux and MacOS.

Windows platform can be particuarly slow in debug mode due to iterator
debugging and secure crt layers. Release mode appers to be not affected by the
issue. See http://blogs.warwick.ac.uk/ahazelden/entry/visual_studio_stl/

The following preprocessor directives /D_SECURE_SCL=0;
/D_HAS_ITERATOR_DEBUGGING=0 (i.e. ADD_DEFINITIONS(-D_SECURE_SCL=0
-D_HAS_ITERATOR_DEBUGGING=0) in cmake) might ameliorate the problem. Consider
however that they cannot be used if the application links libraries compiled
with different options (e.g. Boost).

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

Please report tips, improvements or bug to the FastFlow mailing list
(see http://calvados.di.unipi.it/fastflow) or directly to:
 Massimo Torquati <torquati@di.unipi.it> or <massimotor@gmail.com>
 Marco Aldinucci  <aldinuc@di.unito.it>