Alien::...axminddb(3)

💖 Alien::libmaxminddb — it's giving "manual page, but make it cute" 💖

okay so bestie, welcome to the User Contributed Perl Documentation page for Alien::...axminddb(3) — yes the header is all truncated and mysterious like that, that's just how the man page rolls. Anyway. Let's get into it 🦋

---

✨ NAME ✨

Alien::libmaxminddb — find or install libmaxminddb. That's the whole vibe. It finds it, or it installs it. Iconic behavior honestly 💅

---

🌸 VERSION 🌸

version 2.001</purl> — wait, <purple>2.001</purple>. Fresh. Numbered. Slay.

---

🎀 SYNOPSIS 🎀

So the way you use this is you add the library to your dist.ini if you use Dist::Zilla. Not me explaining the whole thing — here's exactly what it looks like:

[@Filter]
-bundle = @Basic
-remove = MakeMaker

[Prereqs / ConfigureRequires]
Alien::libmaxminddb = 0

[MakeMaker::Awesome]
header = use Config;
header = use Alien::libmaxminddb;
WriteMakefile_arg = CCFLAGS => Alien::libmaxminddb->cflags . ' ' . $Config{ccflags}
WriteMakefile_arg = LIBS => [ Alien::libmaxminddb->libs ]

[Prereqs / DevelopRequires]
Dist::Zilla = 0
Dist::Zilla::Plugin::MakeMaker::Awesome = 0

Copy it, paste it, don't overthink it. Periodt. 💖

---

🔥 DESCRIPTION 🔥

MaxMind and DP-IP.com provide geolocation databases in the MaxMind DB file format format. (Yes, "format format" — that's literally what it says, I'm not fixing it, I'm just a girl reading a manpage 😭)

This Perl module finds or installs the C library libmaxminddb, which can read MaxMind DB files. That's it. That's the job. And it does it well 👑

---

🧚 SUBROUTINES/METHODS 🧚

💜 cflags

my $cflags = Alien::libmaxminddb->cflags;

Returns the C compiler flags necessary to compile an XS module that uses libmaxminddb. Basically it hands you the compiler gossip you need 💅

💜 libs

my $libs = Alien::libmaxminddb->libs;

Returns the library linker flags necessary to link an XS module against libmaxminddb. Link it up bestie 🔗

💜 version

my $version = Alien::libmaxminddb->version;

Returns the libmaxminddb version. Just the number. No drama. ✨

💜 install_type

my $install_type = Alien::libmaxminddb->install_type;

Returns "system" if the library is provided by the operating system, or "share" if the bundled library is used. Two options, both valid, we love a binary 🌈

---

🌟 DIAGNOSTICS 🌟

None. Zero. Nada. Nothing to see here, no diagnostics, we're chill 😌

---

🌟 CONFIGURATION AND ENVIRONMENT 🌟

None. No env vars, no config files, no homework. Enjoy the peace 🕊️

---

🍓 DEPENDENCIES 🍓

Install pkg-config and libmaxminddb-devel or libmaxminddb-dev if you would like to use your operating system's libmaxminddb library.

That's the whole to-do list. Get those, use the system one, be free 🦋

---

🌈 INCOMPATIBILITIES 🌈

None. Nothing fights with it. It's a lover not a fighter 💖

---

💀 BUGS AND LIMITATIONS 💀

None known. No cap. If you find one though, you know what to do 🙈

---

👑 SEE ALSO 👑

• Geo::Location::IP
• IP::Geolocation::MMDB

Go read those too, they're the extended universe iykyk 📚✨

---

🫶 ACKNOWLEDGEMENTS 🫶

Thanks to all who have contributed patches and reported bugs:

• Alex Granovskiy

We see you, we appreciate you, you ate 🎀

---

⭐ AUTHOR ⭐

Andreas Vögele <voegelas@cpan.org>

The main character of this module, fr fr 💅

---

💖 LICENSE AND COPYRIGHT 💖

Copyright (C) 2025 Andreas Vögele

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

The libmaxminddb library is licensed under the Apache License, Version 2.0.

---

and that's the page!! this was perl v5.42.0, dated 2025-07-25, filed under Alien::...axminddb(3) — love that for us, mwah, bye bestie 🫶💖✨