Skip to content

Building

Jump to bottom
Joachim Metz edited this page Sep 20, 2014 · 6 revisions

Introduction

The libhmac source code can be build with different compilers:

  • Using GNU Compiler Collection (GCC)
    • Using Cygwin
  • Using Minimalist GNU for Windows (MinGW)
  • Using Microsoft Visual Studio

Or directly packaged with different package managers:

  • Using Debian package tools (DEB)
  • Using RedHat package tools (RPM)
  • Using Mac OS X pkgbuild

Getting the source

Source package

To retrieve the source package go to the downloads page and download the file named:

libhmac-alpha-<version>.tar.gz

To extract the source package run:

tar xfv libhmac-alpha-<version>.tar.gz

This will create the source directory:

libhmac-<version>

Git

To retrieve the source from the git repository make sure to install: git, aclocal, autoconf, automake, autopoint, gettextize and libtoolize.

To download and prepare the source for building run:

git clone https://github.com/libyal/libhmac.git
cd libhmac/
./synclibs.sh
./autogen.sh

Note that the source from the git repository will not work without synchronizing the library dependencies "./synclibs.sh" and having the autotools generate the necessary files "./autogen.sh".

Using GNU Compiler Collection (GCC)

Before you build the libhmac source code using the GNU Compiler Collection (GCC) you'll need to have compilation and build tools installed.

  • On a Linux system make sure you have build-essential (Debian-based) or the Development Tools (RedHat-based) packages installed.
  • On a Mac OS X system make sure you have XCode (with command line tools) or MacPorts (or equivalent) installed.

Also make sure to have the following dependencies including source headers installed:

  • libcrypto (part of OpenSSL) (optional but recommended)

To build the libhmac source code change into the source directory and run the following commands:

./configure
make

You can install the binaries that were build by running:

sudo make install

By default this will install the binaries in /usr/local. If you want to change this to e.g. /usr, add the configuration option --prefix=/usr, e.g.

./configure --prefix=/usr

On Linux make sure libhmac.so is in the library cache. Normally it suffices to run:

sudo ldconfig

Verbose and debug output

To troubleshoot issues or for low-level format analysis libhmac supports verbose and debug output.

To enable verbose and debug output support add --enable-verbose-output and --enable-debug-output to configure, e.g.

./configure --enable-verbose-output --enable-debug-output

This will generate vast amounts of debug information on stderr when the tools are run with -v.

Static library

To make a static library add --enable-shared=no to configure, .e.g:

./configure --enable-shared=no

Cygwin

If you want to use Cygwin to build libhmac make sure to have the following packages installed:

  • autoconf
  • automake
  • binutils
  • gcc-core
  • gettext
  • libiconv
  • libtool
  • make
  • openssl-devel (optional but recommended)

After following the GNU Compiler Collection (GCC) build instructions you should end up with the following DLL:

libhmac/.libs/cyghmac-0.dll

Using the DLL

Make sure you use define LIBHMAC_DLL_IMPORT before including <libhmac.h>.

  • TODO describe dependencies

Mac OS X

Universal binary

With XCode you can build a Mac OS X universal binary to run on multiple architectures. The supported architectures and exact command differs per version of Mac OS X.

libtoolize

If you find that libtoolize is missing use glibtoolize instead.

Mac OS X 10.4

E.g. on Mac OS X 10.4 to build an PPC and Intel 32-bit multi binary, run the following commands:

CFLAGS="-isysroot /Developer/SDKs/MacOSX10.4u.sdk -arch ppc -arch i386" \
LDFLAGS="-Wl,-syslibroot,/Developer/SDKs/MacOSX10.4u.sdk -arch ppc -arch i386" \
./configure --disable-dependency-tracking
make
make install

Mac OS X 10.6

E.g. on Mac OS X 10.6 to build an Intel 32-bit and 64-bit multi binary, run the following commands:

CFLAGS="-isysroot /Developer/SDKs/MacOSX10.6.sdk -arch x86_64 -arch i386" \
LDFLAGS="-Wl,-syslibroot,/Developer/SDKs/MacOSX10.6.sdk -arch x86_64 -arch i386" \
./configure --disable-dependency-tracking
make
make install

Mac OS X 10.7

E.g. on Mac OS X 10.7 to build an Intel 32-bit and 64-bit multi binary, run the following commands:

CFLAGS="-isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.7.sdk -arch x86_64 -arch i386" \
LDFLAGS="-Wl,-syslibroot,/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.7.sdk -arch x86_64 -arch i386" \
./configure --disable-dependency-tracking
make
make install

Sun Solaris

To build libhmac on Sun Solaris make sure that /usr/ccs/bin and /usr/sfw/bin are defined in the PATH environment variable.

Using Minimalist GNU for Windows (MinGW)

To compile libhmac using MinGW you'll need:

  • MinGW
  • Windows Crypto API (libadvapi32) (optional but recommended)

To build use:

mingw32-configure --prefix=/opt/local/i386-mingw32 --enable-winapi=yes
mingw32-make

It is recommended that you use WINAPI support but it is possible to compile libhmac without it (--enable-winapi=no). The default behavior is that configure will try to auto-detect MinGW and enable WINAPI support.

If mingw32-configure and mingw32-make are not available you can build it with:

./configure --host=i386-mingw32 --prefix=/opt/local/i386-mingw32 --enable-winapi=yes
make

If this does not work try a script similar to the following:

#!/bin/sh
CC=/opt/local/bin/i386-mingw32-gcc
CXX=/opt/local/bin/i386-mingw32-g++
AR=/opt/local/bin/i386-mingw32-ar
OBJDUMP=/opt/local/bin/i386-mingw32-objdump
RANLIB=/opt/local/bin/i386-mingw32-ranlib
STRIP=/opt/local/bin/i386-mingw32-strip
MINGWFLAGS="-mwin32 -mconsole -march=i586 "
CFLAGS="$MINGWFLAGS"
CXXFLAGS="$MINGWFLAGS"

CC=$CC CXX=$CXX AR=$AR OBJDUMP=$OBJDUMP RANLIB=$RANLIB STRIP=$STRIP ./configure --host=i586-mingw32msvc --prefix=/opt/local/i386-mingw32 --enable-winapi=yes
CC=$CC CXX=$CXX AR=$AR OBJDUMP=$OBJDUMP RANLIB=$RANLIB STRIP=$STRIP CFLAGS="$CFLAGS" CXXFLAGS="$CXXFLAGS" make

If you get compiler errors like:

#error WINAPI file open function for Windows 2000 or earlier NOT implemented yet

That means WINVER is not set or set to a version predating Windows XP (0x0501) and you'll have to set WINVER manually like:

CFLAGS=-DWINVER=0x0501 ./configure --host=i386-mingw32 --enable-winapi=yes

You should end up with the following DLL:

libhmac/.libs/libhmac-1.dll

To install libhmac and tools in the MinGW build tree use:

sudo make install

Using MSYS-MinGW

MSYS-MinGW provides means to run configure on Windows.

Installing MSYS-MinGW

Download mingw-get from http://www.mingw.org/

Install mingw-get, you'll only need the command line interface.

More information can be found here.

Start a command prompt and change into the MinGW binaries directory:

cmd.exe
cd C:\mingw\bin\

To install the required MinGW and MSYS packages run:

mingw-get install binutils mingw-runtime w32api libgmp libmpc libiconv pthreads gettext libz gcc-core mingw32-make msys

Building with MSYS-MinGW

Start the MSYS shell:

C:\MinGW\msys\1.0\msys.bat

Make sure the MinGW directory is mounted, otherwise run the following command to mount:

mkdir /mingw
mount C:\\MinGW /mingw

Note: make sure to use the the double \ and that /mingw has no trailing /

To build use:

tar xfv libhmac-alpha-<version>.tar.gz
cd libhmac-<version>/
CPPFLAGS=-DWINVER=0x0501 ./configure --prefix=/mingw
make

Using the DLL

Make sure you use define LIBHMAC_DLL_IMPORT before including <libhmac.h>.

  • TODO describe dependencies

Troubleshooting

While running make I get an error similar to the following:

libclocale_locale.c: In function 'libclocal_local_get_decimal_point':
libclocale_locale.c:357:2: warning implicit declaration of function 'GetLocaleInfoEx' [-Wimplicit-function-declaration]
libclocale_locale.c:358:7: error: 'LOCALE_NAME_USER_DEFAULT' undeclared (first use in this function)
libclocale_locale.c:358:7: note: each undeclared identifier is reported only once for every function it appears in

The version of MinGW does not support a WINAPI version of Vista or later (0x0600) try setting WINVER to 0x0501.

Using Microsoft Visual Studio

Before you build libhmac using Microsoft Visual Studio you'll need to have it installed. The libhmac packages comes with Microsoft Visual Studio files for version 2008. Version 2010 is able to convert these files into its newer versions.

The Microsoft Visual Studio express version is sufficient. Note that if you want to build 64-bit version with the express version you'll need at least 2010. Also see the section: Microsoft Visual Studio 2010 express and 64-bit compilation.

Note that if you want to build libhmac from source checked out of git with Visual Studio make sure the autotools are able to make a distribution package of libhmac before trying to build it. You can create distribution package by running: "make dist".

To compile libhmac using Microsoft Visual Studio you'll need:

  • Windows Crypto API (libadvapi32) (optional but recommended)

Verbose and debug output

To troubleshoot issues or for low-level format analysis libhmac supports verbose and debug output.

To enable verbose and debug output support edit:

common\config_winapi.h

Add the following definitions:

#define HAVE_VERBOSE_OUTPUT     1
#define HAVE_DEBUG_OUTPUT       1

Building

Open the file:

msvscpp\libhmac.sln

Note that the project files contain a Release and VSDebug configuration. The VSDebug builds the binaries with debug information. Note that this is not the same as debug output.

Make sure to check if your build environment defines the correct WINVER for your build. The code uses WINAPI version specific functions based on WINVER. You can define a custom WINVER in the Microsoft Visual Studio C++ project files or in common\config_winapi.h

And build the solution. The build files will be places in:

msvscpp\Release\

Using MSBuild

Another way to build libhmac with Visual Studio is to use MSBuild via the command line. MSBuild can be installed as part of the Microsoft.NET Framework.

First set-up the Visual Studio variables:

C:\Program Files\Microsoft Visual Studio 9.0\VC\bin\vcvars32.bat

Next run MSBuild:

msbuild msvscpp\libhmac.sln /p:Configuration=Release;Platform=Win32

Using the DLL

Make sure you use define LIBHMAC_DLL_IMPORT before including <libhmac.h>.

On other systems than the build system you'll also need to install the Visual Studio Redistributable package for the DLL to run.

64-bit with Microsoft Visual Studio express

To build a 64-bit version of libhmac with Microsoft Visual Studio express you'll need at least the 2010 version.

Microsoft Visual Studio 2010

First make sure to enabling 64-bit compilation support on Microsoft Visual Studio 2010 express. Since this can be a tedious process, some relevant links:

If you have set it up correctly the following should work:

Go to:

Configuration manager -> Active solution platform

Select "<New>"

  • Type or select the new platform: "x64"
  • Copy settings from: "Win32"
  • Create new project platforms: enabled

Additionally for every project change:

Configuration Properties -> General -> Platform Toolset

Into "Windows7.1SDK"

If you've Cygwin installed on your Visual Studio build machine you can try running one of the following scripts to add the x64 settings for you:

sh msvscpp/scripts/vs2008_x64.sh

Make sure to convert the solution first from 2008 to 2010.

sh msvscpp/scripts/vs2010_x64.sh

Using Debian package tools (DEB)

To build libhmac using the Debian package tools make sure you have the following packages installed:

sudo apt-get install build-essential debhelper fakeroot autotools-dev libssl-dev

To build the Debian packages change into the source directory and run:

cp -rf dpkg debian
dpkg-buildpackage -rfakeroot

This will create the following files in the parent directory:

libhmac_<version>-1_<arch>.deb
libhmac-dev_<version>-1_<arch>.deb

To install, e.g. the library:

sudo dpkg -i libhmac_<version>-1_<arch>.deb

Using RedHat package tools (RPM)

To build libhmac using the RedHat package tools make sure you have the following packages installed:

yum install rpm-build openssl-devel

To build:

mv libhmac-alpha-<version>.tar.gz libhmac-<version>.tar.gz
rpmbuild -ta libhmac-<version>.tar.gz

This will create the following files in the rpmbuild directory:

~/rpmbuild/RPMS/<arch>/libhmac-<version>-1.<arch>.rpm
~/rpmbuild/RPMS/<arch>/libhmac-devel-<version>-1.<arch>.rpm
~/rpmbuild/SRPMS/libhmac-<version>-1.src.rpm

To install, e.g. the library:

sudo rpm -ivh libhmac-<version>-1.<arch>.rpm

Mac OS X package

pkgbuild can be used to create a Mac OS X package.

The following instructions show how to build libhmac.pkg and libhmac.dmg from the command line.

First build libhmac with Python-bindings:

./configure --prefix=/usr
make

Next install the build files using DESTDIR

make install DESTDIR=$PWD/tmp

This will make sure that library paths in the dylib file is set correctly for distribution. This is not the case when you use:

./configure --prefix=$PWD/tmp

You can check the library paths in the dylib by running:

otool -LT tmp/usr/lib/libhmac.1.dylib

After running "make install" the binaries are installed in:

$PWD/tmp/

If you are planning to distribute libhmac.pkg make sure it contains a copy of LGPL license:

mkdir -p $PWD/tmp/usr/share/doc/libhmac
cp AUTHORS COPYING NEWS README $PWD/tmp/usr/share/doc/libhmac

To create the package (directory):

pkgbuild --root $PWD/tmp --identifier com.github.libyal.libhmac --version <version> --ownership recommended ../libhmac-<version>.pkg

To create a distributable disk image:

hdiutil create ../libhmac-<version>.dmg -srcfolder ../libhmac-<version>.pkg -fs HFS+
Clone this wiki locally