NAME

Alien::libmaxminddb - Find or download and install libmaxminddb

VERSION

version 1.012

SYNOPSIS

Add the library to your dist.ini if you use Dist::Zilla.

  [@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

DESCRIPTION

MaxMind and DP-IP.com provide geolocation databases in the MaxMind DB file format format. This Perl module finds or downloads and installs the C library libmaxminddb, which can read MaxMind DB files.

SUBROUTINES/METHODS

All methods are inherited from Alien::Base.

DIAGNOSTICS

None.

CONFIGURATION AND ENVIRONMENT

None.

DEPENDENCIES

Requires Alien::Build from CPAN. On Windows, Alien::MSYS needs to be installed manually.

Install the package libmaxminddb-devel or libmaxminddb-dev if you would like to use your operating system's libmaxminddb library.

INCOMPATIBILITIES

None.

BUGS AND LIMITATIONS

If libmaxminddb and its development files aren't present, the library is fetched from GitHub and built with Alien::Build, which requires the build tools from Alien::MSYS on Windows. If Alien::Build fails to build libmaxminddb, make sure that you have a clean build environment with nothing but Perl and the build tools in your path.

SEE ALSO

Alien::Base, IP::Geolocation::MMDB

ACKNOWLEDGEMENTS

Thanks to all who have contributed patches and reported bugs:

  • Alex Granovskiy

AUTHOR

Andreas Vögele <voegelas@cpan.org>

LICENSE AND COPYRIGHT

Copyright (C) 2023 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.