Skip to content

Latest commit

 

History

History
129 lines (84 loc) · 3.81 KB

installation.rst

File metadata and controls

129 lines (84 loc) · 3.81 KB
Raw

Installation

In order to be installed on a system, AFF3CT can either be compiled locally and installed (see From Source), or remotely precompiled versions can be downloaded and installed (see Precompiled Versions.)

From Source

Once has been compiled, it is possible (not mandatory) to install it on your system. On Unix-like systems, traditionally, the fresh build is installed in the /usr/local directory (this is the CMake default installation path). This location can be changed by setting the CMAKE_INSTALL_PREFIX built-in variable with an other path. For instance, to install in the current build:

cmake .. -DCMAKE_INSTALL_PREFIX="install"

This command do not install . It only prepares the project to be installed in the selected location.

Makefile Project

To install , call the install target on the current Makefile:

make install

Note

Depending on the chosen CMAKE_INSTALL_PREFIX location, the administrator privileges (sudo) can be required.

Visual Studio Solution

In case of a Visual Studio Solution, an INSTALL project is defined and ensures the installation when triggered. This can be done from the Visual Studio IDE or from the command line after calling the %VS_PATH%\VC\Auxiliary\Build\vcvars64.bat batch script (where %VS_PATH% is the location of Visual Studio on your system):

devenv /build Release aff3ct.sln /project INSTALL

Precompiled Versions

From website

If you do not plan to modify the source code and you want to use the simulator/library as is, you can download one of the latest builds from the download page of the AFF3CT website. Precompiled binaries are available for the most common operating systems : Windows, macOS and Linux.

On Debian / Ubuntu

Each new version of is deployed on repositories for the aptitude package manager. Two different repositories are available. The first one, stable, holds versions that are released after a lot of testing to ensure performance and stability. The second one, dev, holds the latest development versions of .

Select the channel to use (stable or dev, not both!):

# stable
sudo add-apt-repository ppa:aff3ct/aff3ct-stable

# dev
sudo add-apt-repository ppa:aff3ct/aff3ct-dev

Update package list and install:

sudo apt-get update
sudo apt-get install aff3ct-bin aff3ct-doc libaff3ct libaff3ct-dev
  • The package aff3ct-bin contains the bin/, conf/ and refs/ folders.
  • The package aff3ct-doc contains the doc/ folder.
  • The package libaff3ct contains the lib/ folder.
  • The package libaff3ct-dev contains the include/ folder and depends on the libaff3ct package.

Contents

The installed package is organized as follow:

  • bin/
    • aff3ct-M.m.p the executable binary.
  • include/
    • aff3ct-M.m.p/ contains all the includes required by .
  • lib/
    • libaff3ct-M.m.p.a the static library.
    • libaff3ct-M.m.p.so the shared library.

    • cmake/

      • aff3ct-M.m.p/ contains the CMake configuration files required to link with .
  • share/

    • aff3ct-M.m.p

      • conf/ contains some input files to configure the simulator.
      • refs/ many results from simulations.
      • doc/ contains the documentation.

M stands for the major number of the version, m the minor number and p the id of the last patch.