IP::World is Copyright (C) 2010, Craig MacKenna <
[email protected]>
DESCRIPTION
IP::World returns the ISO-3166 country code associated with an IP4
address. It uses two free databases from WIPmania.com and MaxMind.com.
The included application 'maint_ip_world_db' checks whether the
included IP::World database needs updating during installation, and
can be run or scheduled to keep it current. WIPmania.com and
MaxMind.com release new source data bimonthly and monthly,
respectively. On a server, 'maint_ip_world_db' can be scheduled
(cron'ed on Unix/Linux) to run at an unbusy time.
LICENSE INFORMATION
This module is free software; you may redistribute it and/or modify
it under the same terms as Perl 5.10.1. For more details, see the
full text of the licenses at
<
http://www.perlfoundation.org/artistic_license_1_0> and
<
http://www.gnu.org/licenses/gpl-2.0.html>.
This program is distributed in the hope that it will be useful, but
it is provided "as is" and without any express or implied warranties.
For details, see the full text of the licenses at the above URLs.
INSTALLATION
During the installation you will be asked if you want to enter a
command for 'maint_ip_world_db' to run when the database is updated.
(The author enters a command to restart his Apache server at this point.)
If you don't want to use this feature, just hit Return.
Easy ways to install IP::World:
$ perl -MCPAN -e "install IP::World"
OR
$ perl -MCPANPLUS -e 'fetch IP::World'
The classic way:
Choose a directory to use for installing.
Move/download the distribution file IP-World-n.nn.tar.gz into that directory
cd into the directory
$ tar -xf IP-World-n.nn.tar.gz
This will produce a new directory IP-World-n.n.
$ cd IP-World-n.n
$ perl Build.PL
$ ./Build
$ ./Build test
Assuming those steps don't show any problems:
$ sudo ./Build install (or just ./Build install if you're superuser)
Windows users can omit the './' and just type Build.
Either of the above alternatives should install IP::World into the
Perl library.
See the POD documentation for further details. Once the module
is installed, you should be able to read the documentation by
typing the following from the command-line:
$ perldoc IP::World
Or if your man system is configured in a compatible way:
$ man IP::World
NOTES
This module requires perl 5.7.3 or later.
The author uses it for customizing web pages on his server to the
location of the visitor, particularly to quote prices of items
for sale in the visitor's currency. Also for server log analysis.
Craig MacKenna <
[email protected]>
Apr 7 2010