<!-- GENERATED by docs/sphinx/bin/20-reference (p5) from reference/bundled/FFI/Build/MM.md. Do not edit. -->

```{index} single: FFI::Build::MM
```

# FFI::Build::MM

FFI::Build installer code for ExtUtils::MakeMaker

## VERSION

version 2.12

## SYNOPSIS

In your Makefile.PL:

```perl
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](../Build.md) and [ExtUtils::MakeMaker](../../ExtUtils/MakeMaker.md).
Its interface is influenced by the design of [Alien::Build::MM](https://metacpan.org/pod/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](../Build.md)).
The interface for this file is still under development.

## CONSTRUCTOR

### new

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

Create a new instance of [FFI::Build::MM](MM.md).

## METHODS

### mm\_args

```perl
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

```perl
my $postamble = $fbmm->mm_postamble;
```

This returns the Makefile postamble used by [ExtUtils::MakeMaker](../../ExtUtils/MakeMaker.md).  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)

## COPYRIGHT AND LICENSE

This software is copyright (c) 2015-2022 by Graham Ollis.

This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.