GeoIP 1.5.0
				-----------

*** Experimental IPv6 notice ***

- the experimental IPv6 part of libGeoIP may change in the future.
- It is possible, that geoiplookup and geoiplookup6 will merged.

***

The new perl script geoipupdate-pureperl.pl is a drop in replacement for
geoipupdate. Useful, if you like to customize, pre or postprocess new or
old databases. To archive the databases or signal apache whatever.
Another advantage is, that geoipupdate-pureperl.pl is able to handle proxy
requests even with authentication.

IMPORTANT API Change for 1.3.x and above users for GeoIP Region database
GeoIPRegion.region is no longer a pointer but an in-structure
array so test the first byte of region == 0 rather testing if the region
pointer is NULL.

IMPORTANT API Change for 1.1.x and above users - as of GeoIP 1.1.0 the
GeoIP_country_xxx_by_xxx functions return NULL if a country can not
be found (it used to return '--' or 'N/A'. Be sure to check the
return value for NULL, to avoid segmentation faults!

GeoIP is a C library that enables the user to find geographical and
network information of an IP address.
Included is a free GeoLite Country database
that is updated at the beginning of every month.
To download the latest free GeoLite Country database, go to:
http://dev.maxmind.com/geoip/geolite

There is also a free city-level geolocation database, GeoLite City,
available from:
http://dev.maxmind.com/geoip/geolite

We also offer commercial GeoIP databases with greater accuracy and
additional network information, for more details, see:
https://www.maxmind.com/en/geolocation_landing

As of version 1.4.5 geoipupdate can handle updates via  HTTP Proxy Server.
If the environ variable http_proxy="http://proxy-host:port" is set.
The username:password (as in FTP URLs) is not supported! 
Thanks to Andrew Droffner for the patch!

As of version 1.3.6, the GeoIP C library is thread safe, as long as
GEOIP_CHECK_CACHE is not used.

If you use GeoIP to block access from high risk countries in order
to reduce fraud or abuse, you may want to also block access from known
proxy servers. For more details on our proxy detection service, please visit:
https://www.maxmind.com/en/proxy

To install, run:

./configure
make
make check
make install

The GeoIP C library relies on GNU make, not on BSD make

MEMORY CACHING AND OTHER OPTIONS

There are four options available:

GEOIP_STANDARD - read database from filesystem, uses least memory.

GEOIP_MEMORY_CACHE - load database into memory, faster performance
	but uses more memory

GEOIP_CHECK_CACHE - check for updated database. If database has been updated,
	reload filehandle and/or memory cache.

GEOIP_INDEX_CACHE - just cache
        the most frequently accessed index portion of the database, resulting
        in faster lookups than GEOIP_STANDARD, but less memory usage than
        GEOIP_MEMORY_CACHE - useful for larger databases such as
	GeoIP Organization and GeoIP City. Note, for GeoIP Country, Region
	and Netspeed databases, GEOIP_INDEX_CACHE is equivalent to GEOIP_MEMORY_CACHE

GEOIP_MMAP_CACHE - load database into mmap shared memory ( MMAP is not avail for WIN32 )

The options can be combined using bit operators. For example you can
use both GEOIP_MEMORY_CACHE and GEOIP_CHECK_CACHE by calling:

    GeoIP_open("/path/to/GeoIP.dat", GEOIP_MEMORY_CACHE | GEOIP_CHECK_CACHE);

By default, the city name is returned in iso-8859-1 charset. To obtain the
city name in utf8 instead, run:

    GeoIP_set_charset(gi, GEOIP_CHARSET_UTF8);

To get the netmask of the netblock of the last lookup, use GeoIP_last_netblock(gi).

EXAMPLES

See
test/
     test-geoip.c
     test-geoip-region.c
     test-geoip-city.c
     test-geoip-isp.c
     test-geoip-org.c
     test-geoip-netspeed.c

for examples of how to use the API. The test-geoip.c program works with both the GeoLite and
GeoIP Country databases. The test-geoip-city.c program works with both the GeoLite and
GeoIP City databases. The other example programs require the paid databases available
https://www.maxmind.com/en/geolocation_landing


AUTOMATIC UPDATES

MaxMind offers a service where you can have your database updated
automically each week. For more details see:

http://www.maxmind.com/en/license_key

RESOURCES Mailinglists

Please join the very low traffic mailinglists you are interested in.

http://sourceforge.net/mail/?group_id=66844

Preformance Patches.

Patrick McManus provide a patch to enhance the lookupspeed in MEMORY_CACHE mode. If you feel, that the current MEMORY_CACHE mode is to slow try the patch:

http://sourceforge.net/mailarchive/forum.php?forum_name=geoip-c-discuss&max_rows=25&style=nested&viewmonth=200803

RESOURCES Development version

Please find the latest version of the CAPI on github.

https://github.com/maxmind/geoip-api-c

TROUBLESHOOTING

In case of trouble building from source with libtool or autotools, run
./bootstrap or autoreconf -vfi or aclocal && autoconf && automake --add-missing
to update the generated configuration files.

The Windows build is not thread-safe in STANDARD mode b/c the pread is not
thread-safe.

If you run into trouble building your application with GeoIP support, try adding -fms-extensions to your CFLAGS. If you use Solaris and there C-Compiler use -features=extensions instead. These options enable unnamed union support and fix problems like: 'improper member use: dma_code' or 'GeoIPRecord' has no member named 'dma_code'.

Note that it is recommended that you use GNU make. Also, if you are using
OpenBSD, GeoIP requires OpenBSD 3.1 or greater.

if you get "cannot load shared object file: No such file or directory"
error, add the directory libGeoIP.so was installed to to /etc/ld.so.conf
and run ldconfig

On Solaris, if you get a
ld: fatal: relocations remain against allocatable but non-writable sections
error, try running

# make clean
# ./configure --disable-shared
# make

If you get a "ar : command not found" error, make sure that ar is
in your path. On Solaris, ar is typically found in /usr/ccs/bin

If you get a "geoipupdate.c:24: getopt.h: No such file or directory"
error, run

# export CPPFLAGS="-I/usr/local/include"

(assuming that getopt.h is in /usr/local/include)

If you get a "zlib.h: No such file or directory" error, make sure
that the zlib development libraries are installed on your server.
These are typically included in a "zlib-devel" package.

If you get a "bad interpreter: No such file or directory" error
when running ./configure, make sure that there are no DOS
returns in the configure script. To remove DOS returns,
run perl -pi -e 's!\r!!g' configure.

If gcc fails while consuming a large amount of memory, try
compiling with CFLAGS=-O1 (or -O0) instead of the default -O2.
It seems that some
versions of gcc have a bug and consume 1 GB of memory when optimizing
certain source files (the other source file where this was reported is
from XORG X-Server). It happens at least with gcc 3.3.1 and with gcc
4.2(.0). Thanks to Kai Schaetzl for the report.

If GEOIP_MMAP_CACHE doesn't work on a 64bit machine, try adding
the flag "MAP_32BIT" to the mmap call.

If you get a "passing argument 3 of 'gethostbyname_r' from incompatible pointer type"
error on AIX, download and/or untar a fresh copy of GeoIP. ( To avoid cached
results from a previous ./configure run )

cd ./GeoIP-1.4.6
then edit the file ./configure

and delete these two lines:

#define HAVE_GETHOSTBYNAME_R 1

#define GETHOSTBYNAME_R_RETURNS_INT 1

then save the configure script

and build it as usual

./configure
make
sudo make install



To submit a patch, please contact support@maxmind.com 

# how to build under MinGW/MSYS:
# (first you need to build & "install" zlib)

export "CFLAGS=-O3 -I/usr/local/include"
export "LDFLAGS=-L/usr/local/lib -lwsock32 -lws2_32"
./configure
make
cp data/GeoIP.dat test/
make check

# note that GeoIP.dat file should be placed in the
# same place as GeoIP-enabled executable modules!
# there's NO DEFAULT PATH concept on Win32 :)

#!/bin/sh
#
# Building OSX fat binaries is easy.
#
# - start in a clean directory.
# - copy the shell script below to a file and edit the file to your needs.
#
# 1.) modify export GEOIP_ARCH='-arch i386 -arch x86_64 -arch ppc -arch ppc64'
# to include all architectures you need.
# 2.) add whatever you want to the ./configure line.
# 3.) execute the script.
# 4.) do a 'make install'
#
#
# make clean or make distclean before building this
#
# tell systems before leopard that we like to build for 10.5 or higher
# with MACOSX_DEPLOYMENT_TARGET=10.5
# starting with leopard we have to add -mmacosx-version-min=10.5
# to the CFLAGS and export MACOSX_DEPLOYMENT_TARGET!?

##  for tiger, leopard and snow leopard you might use this
## export GEOIP_ARCH='-arch i386 -arch x86_64 -arch ppc -arch ppc64'
## export MACOSX_DEPLOYMENT_TARGET=10.4
## export LDFLAGS=$GEOIP_ARCH
## export CFLAGS="-mmacosx-version-min=10.4 -isysroot /Developer/SDKs/MacOSX10.4u.sdk $GEOIP_ARCH"

# here we go for leopard and snow leopard
#export GEOIP_ARCH='-arch i386 -arch x86_64 -arch ppc'
#export MACOSX_DEPLOYMENT_TARGET=10.5
#export LDFLAGS=$GEOIP_ARCH
#export CFLAGS="-g -mmacosx-version-min=10.5 -isysroot /Developer/SDKs/MacOSX10.5.sdk $GEOIP_ARCH"
#./configure --disable-dependency-tracking
#perl -i.bak -pe'/^archive_cmds=/ and !/\bGEOIP_ARCH\b/ and s/-dynamiclib\b/-dynamiclib \\\$(GEOIP_ARCH)/' ./libtool
#make

# and this is lion with the new xcode
P=`xcode-select -print-path`
export GEOIP_ARCH='-arch i386 -arch x86_64'
export MACOSX_DEPLOYMENT_TARGET=10.7
export LDFLAGS=$GEOIP_ARCH
export CFLAGS="-g -mmacosx-version-min=10.7 -isysroot $P/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.7.sdk $GEOIP_ARCH"
./configure --disable-dependency-tracking
make

=======================================================

Environmental variables:

1. GeoIPDBFileName is hardcoded to "\\windows\\system32\\GeoIP.dat" on
windows in GeoIP.c
2. #ifdef DLL is used to determine whether you want to have a DLL built
in GeoIP.h

You may want to change these depending on your system configuration
and compiler.

=======================================================
Thanks to Chris Gibbs for supplying these instructions.

The GeoIP C library should work under windows.  Note that it requires the zlib
DLL.

To install zlib with GeoIP:

i) Downloda the zlib prebuilt DLL and static library from
http://www.winimage.com/zLibDll/ look for "pre-built zlib DLL".

Unzip it to some location on your hard drive, and in Project-->Settings ,
go to the Link tab, and add the following 3 libraries:

ws2_32.lib
zlib.lib
zlibstat.lib

iii) Go to Tools-->Options, then the Directories tab, and add library paths to
the locations of the zlib static libraries. You will also need to add the
include path to zlib.h to the include paths.

iv) NOTE: These instructions are for MS VC++ 6.0, but should be similar for
previous versions, and for VC .NET.

=======================================================
Building GeoIP as a DLL

Stanislaw Pusep has contributed a patch for building GeoIP as a DLL.
You can find the patch in GeoIPWinDLL.patch

Note a modified version of this patch is now merged into the main code.

To make a static GeoIP.lib, edit the top level
Makefile.vc to reflect where the GeoIP.dat database
file should be placed, as well as the locations
of the lib, include, and bin directories for installation.
Then give the command
   nmake /f Makefile.vc
This will build the GeoIP.lib library, as well as available
application and test programs. The command
   nmake /f Makefile.vc test
will run available tests in the test/ subdirectory.
   nmake /f Makefile.vc install
will then copy the lib and header files to the locations
specified in the top-level Makefile.vc, as well as
available application programs in the apps/ subdirectory.
   nmake /f Makefile.vc clean
will remove intermediate object and executable files.

Indexes created Thu May 30 22:23:56 MDT 2024