"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "README.md" between
GeoIP-1.6.11.tar.gz and GeoIP-1.6.12.tar.gz

About: GeoIP is a C library that enables the user to find the country that any IP address or hostname originates from (contains an initial free GeoIP Country database).

README.md  (GeoIP-1.6.11):README.md  (GeoIP-1.6.12)
skipping to change at line 16 skipping to change at line 16
format (mmdb) used by GeoIP2, please see format (mmdb) used by GeoIP2, please see
[libmaxminddb](https://github.com/maxmind/libmaxminddb). [libmaxminddb](https://github.com/maxmind/libmaxminddb).
## Description ## ## Description ##
The GeoIP Legacy C library enables the user to find geographical and network The GeoIP Legacy C library enables the user to find geographical and network
information of an IP address. To use this library, you may download our free information of an IP address. To use this library, you may download our free
GeoLite Legacy Country or City databases. These are updated at the beginning GeoLite Legacy Country or City databases. These are updated at the beginning
of every month. The latest versions are available at: of every month. The latest versions are available at:
http://dev.maxmind.com/geoip/legacy/geolite https://dev.maxmind.com/geoip/legacy/geolite
We also offer commercial GeoIP Legacy databases with greater accuracy and We also offer commercial GeoIP Legacy databases with greater accuracy and
additional network information. For more details, see: additional network information. For more details, see:
https://www.maxmind.com/en/geolocation_landing https://www.maxmind.com/en/geolocation_landing
If you use GeoIP Legacy to block access from high risk countries, you may wish If you use GeoIP Legacy to block access from high risk countries, you may wish
to use our proxy detection service to block access from known proxy servers to to use our proxy detection service to block access from known proxy servers to
reduce fraud and abuse. For more details, see: reduce fraud and abuse. For more details, see:
skipping to change at line 46 skipping to change at line 46
### On Ubuntu Using PPA ### ### On Ubuntu Using PPA ###
MaxMind provides a PPA for recent version of Ubuntu. To add the PPA to your MaxMind provides a PPA for recent version of Ubuntu. To add the PPA to your
APT sources, run: APT sources, run:
$ sudo add-apt-repository ppa:maxmind/ppa $ sudo add-apt-repository ppa:maxmind/ppa
Then install the packages by running: Then install the packages by running:
$ sudo aptitude update $ sudo apt update
$ sudo aptitude install libgeoip1 libgeoip-dev geoip-bin $ sudo apt install libgeoip1 libgeoip-dev geoip-bin
### From Source on Unix/Linux ### ### From Source on Unix/Linux ###
To install, run: To install, run:
``` ```
./configure ./configure
make make
make check make check
make install make install
skipping to change at line 119 skipping to change at line 119
* `GEOIP_SILENCE` - Disables diagnostic messages to stderr in the library; * `GEOIP_SILENCE` - Disables diagnostic messages to stderr in the library;
error conditions are detectable via the return values. error conditions are detectable via the return values.
These options can be combined using bit operators. For example you can These options can be combined using bit operators. For example you can
use both `GEOIP_MEMORY_CACHE` and `GEOIP_CHECK_CACHE by calling`: use both `GEOIP_MEMORY_CACHE` and `GEOIP_CHECK_CACHE by calling`:
```c ```c
GeoIP_open("/path/to/GeoIP.dat", GEOIP_MEMORY_CACHE | GEOIP_CHECK_CACHE); 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 By default, the city name is returned in the ISO-8859-1 charset. To obtain
city name in utf8 instead, run: the city name in UTF-8 instead, run:
```c ```c
GeoIP_set_charset(gi, GEOIP_CHARSET_UTF8); GeoIP_set_charset(gi, GEOIP_CHARSET_UTF8);
``` ```
To get the netmask of the netblock of the last lookup, use To get the netmask of the netblock of the last lookup, use
`GeoIP_last_netblock(gi)`. `GeoIP_last_netmask(gi)`.
## Examples ## ## Examples ##
See the following files for examples of how to use the API: See the following files for examples of how to use the API:
``` ```
test/ test/
test-geoip.c test-geoip.c
test-geoip-region.c test-geoip-region.c
test-geoip-city.c test-geoip-city.c
skipping to change at line 204 skipping to change at line 204
Note that it is recommended that you use GNU make. Also, if you are using Note that it is recommended that you use GNU make. Also, if you are using
OpenBSD, this library requires OpenBSD 3.1 or greater. OpenBSD, this library requires OpenBSD 3.1 or greater.
If you get a "cannot load shared object file: No such file or directory" If you get a "cannot load shared object file: No such file or directory"
error, add the directory `libGeoIP.so` was installed to the `/etc/ld.so.conf` error, add the directory `libGeoIP.so` was installed to the `/etc/ld.so.conf`
file and run `ldconfig`. file and run `ldconfig`.
#### Solaris #### #### Solaris ####
On Solaris, if you get a `ld: fatal: relocations remain against allocatable On Solaris, if you get a `ld: fatal: relocations remain against allocatable
but non-writable sections`, try runnign: but non-writable sections`, try running:
``` ```
make clean make clean
./configure --disable-shared ./configure --disable-shared
make make
``` ```
If you get a `ar : command not found` error, make sure that `ar` is in your 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` path. On Solaris, `ar` is typically found in `/usr/ccs/bin`
#### AIX #### #### AIX ####
If you get a `passing argument 3 of 'gethostbyname_r' from incompatible If you get a `passing argument 3 of 'gethostbyname_r' from incompatible
pointer type` error on AIX, untar a fresh copy of thie library and delete the pointer type` error on AIX, untar a fresh copy of this library and delete the
following two lines from `./configure`: following two lines from `./configure`:
``` ```
#define HAVE_GETHOSTBYNAME_R 1 #define HAVE_GETHOSTBYNAME_R 1
#define GETHOSTBYNAME_R_RETURNS_INT 1 #define GETHOSTBYNAME_R_RETURNS_INT 1
``` ```
then save the configure script and build it as usual: then save the configure script and build it as usual:
``` ```
./configure ./configure
make make
sudo make install sudo make install
``` ```
## Bug Tracker ## ## Bug Tracker ##
Please report all issues with this code using the [GitHub issue tracker] Please report all issues with this code using the
(https://github.com/maxmind/geoip-api-c/issues). [GitHub issue tracker](https://github.com/maxmind/geoip-api-c/issues).
If you are having an issue with a MaxMind database that is not specific to If you are having an issue with a MaxMind database that is not specific to
this API, please [contact MaxMind support] this API, please
(http://www.maxmind.com/en/support). [contact MaxMind support](https://www.maxmind.com/en/support).
## Contributing ## ## Contributing ##
To contribute, please submit a pull request on To contribute, please submit a pull request on
[GitHub](https://github.com/maxmind/geoip-api-c/). [GitHub](https://github.com/maxmind/geoip-api-c/).
 End of changes. 8 change blocks. 
12 lines changed or deleted 12 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)