Skip to content

Latest commit

 

History

History
83 lines (54 loc) · 2.75 KB

INSTALL.md

File metadata and controls

83 lines (54 loc) · 2.75 KB

General information

fuseadf requires the ADFlib for building and operation (if the shared library is used).

Testing requires also the Check testing framework for C.

There are 2 buildsystems that can be used: CMake or autotools. Obviously, a requirement for building is installation of the chosen one.

Building with CMake

There are helper scripts in the util/ directory, which should help doing quick builds. For instance, to build the release version:

  1. $ util/cmake_release_configure
  2. $ util/cmake_release_build

Debug version (with gdb and address sanitizer) can be built in the same way, just replace release with debug in the commands above.

To (eventually) remove the build subdirectory use: $ util/cmake_clean

(all have to be configured again for building).

Configuration options can be passed to configure script, for instance: util/cmake_debug_configure -DFUSEADF_ALLOW_USE_AS_ROOT:BOOL=ON

Building with Autotools

Standard way:

  1. $ ./autogen.sh
  2. $ ./configure
  3. $ make

For configuration options, check ./configure --help. One worth notifying is the option for allowing or disallowing (default) using the built fuseadf as root (--enable-use-as-root / --disable...).

Testing

Some tests require presence of test images. They are not stored in the repository and have to be downloaded using a script in tests/testdata/. The images are downloaded from:

Testing with CMake

After successful building (see above), automatic tests can be started with:

  • $ util/test_release (for the release version)
  • $ util/test_debug (for the debug version)

Testing with Autotools

After successful building (see above), automatic tests can be started with: $ make check

Installation with CMake

To default location: $ util/cmake_release_install

To a custom location: $ util/cmake_release_install [custom_prefix]

Installation with autotools

To the configured location: $ make install

To change default location, do: $ ./configure --help and look for prefix options.

Building Debian packages

To build a .deb packages for Debian (or any derivative), use the helper script: $ util/deb_build.sh

In the parent(!) directory of the project, it will create:

  • a source package (.tar.gz)
  • binary packages (.deb)

The source package alone can be created with: $ util/deb_create_quilt3_archive.sh