FFI::Build::MM#

FFI::Build installer code for ExtUtils::MakeMaker

VERSION#

version 2.12

SYNOPSIS#

In your Makefile.PL:

use ExtUtils::MakeMaker;
use FFI::Build::MM;

my $fbmm = FFI::Build::MM->new;

WriteMakefile($fbmm->mm_args(
  ABSTRACT     => 'My FFI extension',
  DISTNAME     => 'Foo-Bar-Baz-FFI',
  NAME         => 'Foo::Bar::Baz::FFI',
  VERSION_FROM => 'lib/Foo/Bar/Baz/FFI.pm',
  ...
));

sub MY::postamble {
  $fbmm->mm_postamble;
}

Then put the C, C++ or Fortran files in ./ffi for your runtime library and ./t/ffi for your test time library.

DESCRIPTION#

This module provides a thin layer between FFI::Build and ExtUtils::MakeMaker. Its interface is influenced by the design of Alien::Build::MM. The idea is that for your distribution you throw some C, C++ or Fortran source files into a directory called ffi and these files will be compiled and linked into a library that can be used by your module. There is a control file ffi/*.fbx which can be used to control the compiler and linker options. (options passed directly into FFI::Build). The interface for this file is still under development.

CONSTRUCTOR#

new#

my $fbmm = FFI::Build::MM->new;

Create a new instance of FFI::Build::MM.

METHODS#

mm_args#

my %new_args = $fbmm->mm_args(%old_args);

This method does two things:

  • reads the arguments to determine sensible defaults (library name, install location, etc).

  • adjusts the arguments as necessary and returns an updated set of arguments.

mm_postamble#

my $postamble = $fbmm->mm_postamble;

This returns the Makefile postamble used by ExtUtils::MakeMaker. The synopsis above for how to invoke it properly. It adds the following Make targets:

  • fbx_build / ffi

    build the main runtime library in ./ffi.

  • fbx_test / ffi-test

    Build the test library in ./t/ffi.

  • fbx_clean / ffi-clean

    Clean any runtime or test libraries already built.

Normally you do not need to build these targets manually, they will be built automatically at the appropriate stage.

AUTHOR#

Author: Graham Ollis plicease@cpan.org

Contributors:

Bakkiaraj Murugesan (bakkiaraj)

Dylan Cali (calid)

pipcet

Zaki Mughal (zmughal)

Fitz Elliott (felliott)

Vickenty Fesunov (vyf)

Gregor Herrmann (gregoa)

Shlomi Fish (shlomif)

Damyan Ivanov

Ilya Pavlov (Ilya33)

Petr Písař (ppisar)

Mohammad S Anwar (MANWAR)

Håkon Hægland (hakonhagland, HAKONH)

Meredith (merrilymeredith, MHOWARD)

Diab Jerius (DJERIUS)

Eric Brine (IKEGAMI)

szTheory

José Joaquín Atria (JJATRIA)

Pete Houston (openstrike, HOUSTON)

Lukas Mai (MAUKE)