Fast XS implementation of MaxMind DB reader
C++ Perl XS C
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
c First stab at uint128 support Oct 7, 2013
dev-bin Create new directories as needed when copying tests from PP repo Oct 7, 2013
inc
lib/MaxMind/DB/Reader Bump version after release Mar 23, 2016
maxmind-db @ 8da9453 Move iteration of search tree to XS using libmaxminddb 1.2.0+ Mar 22, 2016
t Resync tests with PP repo Mar 23, 2016
tools Tidyall code Sep 16, 2015
xt/author Fix bad code tweak in xt/author/leak-check.t Sep 16, 2015
.gitignore Ignore tidyall dir Sep 22, 2014
.gitmodules Use public path for MaxMind-DB repo Oct 1, 2013
.mailmap v1.000001 Dec 21, 2015
.perltidyallrc
.tidyallrc Update test. Add tidyallrc. Tidy. Sep 5, 2014
.travis.yml
.uncrustify.cfg Add uncrustify script & config for XS code Oct 2, 2013
Build.PL
Changes v1.000003 Mar 23, 2016
LICENSE v1.000003 Mar 23, 2016
README-dev.md
README.md v1.000003 Mar 23, 2016
cpanfile Require a recent MaxMind::DB::Metadata Mar 23, 2016
dist.ini Don't test Pod coverage for this distro Dec 21, 2015
perlcriticrc Update generated files Jun 30, 2015
perltidyrc Update generated files Jun 30, 2015
tidyall.ini Placate Perl::Critic for all files and disable tidy checks for others Jun 30, 2015
valgrind.supp Add a README.dev file with some info about valgrind and a suppression… Oct 1, 2013

README.md

NAME

MaxMind::DB::Reader::XS - Fast XS implementation of MaxMind DB reader

VERSION

version 1.000003

SYNOPSIS

my $reader = MaxMind::DB::Reader->new( file => 'path/to/database.mmdb' );

my $record = $reader->record_for_address('1.2.3.4');

DESCRIPTION

Simply installing this module causes MaxMind::DB::Reader to use the XS implementation, which is much faster than the Perl implementation.

The XS implementation links against the libmaxminddb library.

See MaxMind::DB::Reader for API details.

VERSIONING POLICY

This module uses semantic versioning as described by http://semver.org/. Version numbers can be read as X.YYYZZZ, where X is the major number, YYY is the minor number, and ZZZ is the patch number.

MAC OS X SUPPORT

If you're running into install errors under Mac OS X, you may need to force a build of the 64 bit binary. For example, if you're installing via cpanm:

ARCHFLAGS="-arch x86_64" cpanm MaxMind::DB::Reader::XS

SUPPORT

Please report all issues with this code using the GitHub issue tracker at https://github.com/maxmind/MaxMind-DB-Reader-XS/issues.

AUTHORS

CONTRIBUTORS

COPYRIGHT AND LICENSE

This software is Copyright (c) 2016 by MaxMind, Inc.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)