geoip_db_get_all_info(3) [php man page]

GEOIP_DB_GET_ALL_INFO(3)						 1						  GEOIP_DB_GET_ALL_INFO(3)

geoip_db_get_all_info - Returns detailed information about all GeoIP database types

SYNOPSIS

       array geoip_db_get_all_info (void  )

DESCRIPTION

	The geoip_db_get_all_info(3) function will return detailed information as a multi-dimensional array about all the GeoIP database types.

	This function is available even if no databases are installed. It will simply list them as non-available.

	The names of the different keys of the returning associative array are as follows:

	      o "available" -- Boolean, indicate if DB is available (see geoip_db_avail(3))

	      o "description" -- The database description

	      o "filename" -- The database filename on disk (see geoip_db_filename(3))

RETURN VALUES

	Returns the associative array.

EXAMPLES

       Example #1

	      A geoip_db_get_all_info(3) example

	       This will print the array containing all the information.

	      <?php
	      $infos = geoip_db_get_all_info();
	      if (is_array($infos)) {
		  var_dump($infos);
	      }
	      ?>

	      The above example will output:

	      array(11) {
		[1]=>
		array(3) {
		  ["available"]=>
		  bool(true)
		  ["description"]=>
		  string(21) "GeoIP Country Edition"
		  ["filename"]=>
		  string(32) "/usr/share/GeoIP/GeoIP.dat"
		}

	      [ ... ]

		[11]=>
		array(3) {
		  ["available"]=>
		  bool(false)
		  ["description"]=>
		  string(25) "GeoIP Domain Name Edition"
		  ["filename"]=>
		  string(38) "/usr/share/GeoIP/GeoIPDomain.dat"
		}
	      }

       Example #2

	      A geoip_db_get_all_info(3) example

	       You can use the various constants as keys to get only parts of the information.

	      <?php
	      $infos = geoip_db_get_all_info();
	      if ($infos[GEOIP_COUNTRY_EDITION]['available']) {
		  echo $infos[GEOIP_COUNTRY_EDITION]['description'];
	      }
	      ?>

	      The above example will output:

	      GeoIP Country Edition

PHP Documentation Group 												  GEOIP_DB_GET_ALL_INFO(3)

geoip(3)							    Version 0.2 							  geoip(3)

NAME

       geoip - A Tcl extension for geographic or organisational lookup of IP addresses and hostnames.

SYNOPSIS

       geoip open [-type TYPE ] [-flags FLAG ]
       geoip open [-file PATH ] [-flags FLAG ]
       geoip [COMMAND]
       geoip [QUERY] arg1

DESCRIPTION

       This Tcl extension encapsulates most of GeoIP C API functions into tcl commands.

OPEN OPTIONS

       open takes either a file path and a set of flags, or a type and a set of flags.	Supported types and flags are described below.

       TYPE   Looks under the standard installation share directory, eg /usr/local/share/GeoIP/ for a GeoIP database according to type.

       PATH   Absolute/relative path to GeoIP database.

       FLAG   Flags seperated by ':', eg memory_cache:memory_check

COMMAND

       Individual singular commands can be one of:

       close  Close the currently open database.

       db_info
	      Get information about the current database.

       db_edition
	      Returns edition of opened database.

       db_avail
	      Test the availability of databases in your system in known locations. e.g db_avail country_edition

QUERY

       Commands that query the database. All commands return N/A if a result cannot be found. If none already open, a command will attempt to open
       a suitable database. country commands will open a country_edition database. region commands will open a region_edition_rev1 one. name  com-
       mands will open an org_edition one, and the record_edition will open a city_edition_rev1 database. The commands are:

       country_code_by_addr
	      Takes an IP address and returns the ISO-3166-1 Alpha-2 code of the country.

       country_code3_by_addr
	      Takes an IP address and returns the ISO-3166-1 Alpha-3 code the country.

       country_code_by_name
	      Takes a hostname and returns the ISO-3166-1 Alpha-2 code the country.

       country_code3_by_name
	      Takes a hostname and returns the ISO-3166-1 Alpha-3 code the country.

       country_name_by_addr
	      Takes an IP address and returns the country name.

       country_name_by_name
	      Takes a hostname and returns the country name.

       name_by_addr
	      Takes an IP address and returns the organisation name (or ISP/ASnum according to the opened database)

       name_by_name
	      Takes a hostname and returns the organisation name.

       region_by_addr
	      Takes an IP address and returns these region attributes as in an associative array: country, region

       region_by_name
	      Takes a hostname and returns the region attributes.

       record_by_addr
	      Takes  an  IP  address and returns these record attributes as in an associative array: code, code3, region, country, city, postcode,
	      latitude, longitude, dma(dma code), and area (area code)

       record_by_name
	      Takes a hostname and returns the record attributes.

TYPES

       Relevant types of databases are: country_edition, org_edition, isp_edition,  city_edition_rev1,	region_edition_rev1,  geoip_asnum_edition.
       "open -type" will accept their unambiguous abbreviations.

FLAGS

       Valid flags are: standard, memory_cache, check_cache, index_cache.

FILES

       ./share/GeoIP.dat
	      GeoIP country_edition database.

       ./share/GeoIPOrg.dat
	      GeoIP org_edition database.

       ./share/GeoIPCity.dat
	      GeoIP region_city_rev1 database.

       ./share/GeoIPRegion.dat
	      GeoIP region_edition_rev1 database.

       ./share/GeoIPASNum.dat
	      GeoIP asnum_edition database.

BUGS

       Please report to author.

AUTHOR

       Djihed Afifi <djihed@gmail.com>.

SEE ALSO

       GeoIP C API documentation <www.maxmind.com>

Tcl extension							    April 2007								  geoip(3)