NAME

Alien::libmaxminddb - Find or download and install libmaxminddb

VERSION

version 1.007

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.

SEE ALSO

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

AUTHOR

Andreas Vögele <voegelas@cpan.org>

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.

LICENSE AND COPYRIGHT

Copyright 2022 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.