FFI::Build::MM(3pm)

🌸 FFI::Build::MM(3pm) — NAME 🌸

Okay so bestie, meet FFI::Build::MM — literally the FFI::Build installer code for ExtUtils::MakeMaker. It's the glue that lets your FFI extension build in a MakeMaker world, and yes, she's iconic. 💅

🎀 VERSION 🎀

Version 2.11. Periodt.

✨ SYNOPSIS ✨

In your Makefile.PL, do the thing:

 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 is a thin layer between FFI::Build and ExtUtils::MakeMaker. Its interface is influenced by the design of Alien::Build::MM. The idea is literally: for your distribution, you throw some C, C++ or Fortran source files into a directory called ffi, and those files get compiled and linked into a library that your module can use. ✨

There's 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 — so bestie, consider that a work-in-progress vibe. 👑

💖 CONSTRUCTOR 💖

new

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

Create a new instance of FFI::Build::MM. Boom. Object acquired. 🎀

🔥 METHODS 🔥

mm_args

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

This method does two things:

1. reads the arguments to determine sensible defaults (library name, install location, etc).
2. adjusts the arguments as necessary and returns an updated set of arguments.

Lowkey magic, highkey useful. 💜

mm_postamble

my $postamble = $fbmm->mm_postamble;

This returns the Makefile postamble used by ExtUtils::MakeMaker. The synopsis above shows 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. No cap. 🙈

🌈 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.

---

Okay bye bestie 💋 — this page is from perl v5.42.3, dated 2026-08-20, and the module itself is version 2.11. Slay. 🌟