Installation

Linux Instructions

These instructions should work on most Linux distributions.

1. Requirements

The following should be installed before Dasyne is compiled:

• GNU g++ compiler version 4 or later
• Boost library version 1.7 or later
• Zlib library version 1.2.5 or later

If you're installing from a repository (using a package manager), be sure to install the development version of the packages. Under Ubuntu, the following packages should suffice: libboost-all-dev build-essential zlib1g-dev

2. Compiling

Compiling is as simple as:

• cd dasyne_directory
• ./configure
• make
• make install

If configure gives an error like: "C++ compiler cannot create executables", it's most likely that configure couldn't find the zlib library. Verify that the zlib development files are installed, and that it's possible to link to -lz.

If you would like to install somewhere other than the default location, you can pass --prefix=/my_location to the configure script. The last step, make install, should be performed as root.

3. Linking

Link your program to the dasyne, boost and zlib libraries:

g++ MyProgram.cpp -ldasyne -lz -lboost_system-mt

Windows MinGW Instructions

These instructions were tested on Windows 8.1.

1. Install MinGW

Install MinGW gcc 4.4 or later. If the installer asks which thread model to use, pick win32.

• Boost library version 1.7 or later
• Zlib version 1.2.3 or later

2. Set Environment Variables

As of Windows 8.1, environment variables can be added or set by doing the following:

• Right-click on the Windows icon in the lower-left corner of the Desktop view
• A menu should pop-up, select "Control Panel"
• Go to System and Security->System
• Click on Advanced System Settings->Environment Variables...
• Add or edit variables in the "System variables" box
• Restart any open command prompts for the changes to take effect

MINGDIR (create)

• Add a variable named MINGDIR, and set it to MinGW's base directory. The base directory should include MinGW's bin, lib and include subfolders. Eg, C:\Program Files\mingw-w64\x86_64-5.1.0-posix-seh-rt_v4-rev0\mingw64
• To verify, open a command prompt.
• Type echo %MINGDIR%
• The output should be MinGW's location.

PATH (modify)

• Find the PATH variable and add MinGW's bin directory. Eg, C:\Program Files\mingw-w64\x86_64-5.1.0-posix-seh-rt_v4-rev0\mingw64\bin The directories in PATH are separated by semicolons.
• To verify, open a command prompt.
• Type mingw32-make -v
• It should display the GNU make version.

3. Add Boost to MinGW

These instructions were tested with boost 1.58, but should work on later versions.

Dasyne requires Boost's multi-threaded system library, which means that Boost needs to be compiled. As of Boost 1.58, we need to use Boost.Build with the gcc toolset - when you call Boost's bootstrap.bat, you should use bootstrap gcc. See the Boost 'Getting Started Guide' for more information.

Copy the "boost" directory from boost's base directory into MinGW's "include" directory.

By default, Boost gives the system library a different name depending on your compiler and the version of boost. On my system, I found:

• The library location: boost_1_58_0\bin.v2\libs\system\build\gcc-mingw-5.1.0\release\threading-multi
• Library names: libboost_system-mgw51-mt-1_58.dll.a and libboost_system-mgw51-mt-1_58.dll

Copy both files to MinGW's "lib" and "bin" folders.

4. Add Zlib to MinGW

Using Dasyne

To use Dasyne, include Dasyne.hpp:

#include "Dasyne.hpp"

Windows programs should #define DA_WINDOWS_VERSION before including Dasyne.hpp.

All classes, enumerations and constants belong to the libdasyne namespace. They can be accessed either by adding the namespace:

using namespace libdasyne;

or by specifying the scope:

libdasyne::DBuffer myBuffer;