libipg_lookup.c File Reference

ipgeo db lookup routines More...

#include "./libipg.h"

Go to the source code of this file.

Functions
u_int32_t	ipgeo_ipa2ipn (char *ip)
int	ipgeo_lookup (u_int32_t ipn, u_int8_t flags, ipgeo_t *ipg)
char *	ipgeo_get_cc (ipgeo_t *ipg)
char *	ipgeo_get_country (ipgeo_t *ipg)
char *	ipgeo_get_region (ipgeo_t *ipg)
char *	ipgeo_get_city (ipgeo_t *ipg)
char *	ipgeo_get_isp (ipgeo_t *ipg)
double	ipgeo_get_lat (ipgeo_t *ipg)
double	ipgeo_get_long (ipgeo_t *ipg)

---

Detailed Description

ipgeo db lookup routines

Author:

Mike Schiffman

Definition in file libipg_lookup.c.

---

Function Documentation

u_int32_t ipgeo_ipa2ipn (  char *  ip  )

currently we don't deal with hostnames; ip has to be dots n decimals compute first byte (256^3 * o1) compute second byte (256^2 * o2) compute third byte (256 * o3) compute fourth byte (o4) Definition at line 50 of file libipg_lookup.c. { char *p = ip; u_int32_t o1, o2, o3, o4; if (!isdigit(ip[0])) { return (0); } o1 = 16777216 * atol(strsep(&p, ".")); o2 = 65536 * atol(strsep(&p, ".")); o3 = 256 * atol(strsep(&p, ".")); o4 = atol(strsep(&p, ".")); return (o1 + o2 + o3 + o4); }

int ipgeo_lookup (  u_int32_t  ipn, u_int8_t  flags, ipgeo_t *  ipg )

Performs a lookup into the ipg database for the given IPv4 number. If successful, the funcion will fill in internal libipg structure members with location information specific to the queried IPv4 address. Currently libipg supports Country Code, Country, Region, City and ISP information. Depending on the IPv4 number queried; none, some or all of this information may be returned. Currently the only db access method is a linear search through the ASCII CSV file. Expect this to change shortly in favor of something faster, along the lines of O(ln n) or so. The database has over 95% accuracy at the Country and ISP level, 70% at the regional level and 65% at the city level, which, according to the IP2LOCATION documentation, is the highest accuracy available. The country-level inaccuracy is due to dynamic IP address allocation by large ISPs such as AOL and MSN TV. AOL, for example, uses a network that routes all of their Internet traffic through Reston, Virginia. As such, all IP-based geo-location databases are unable to determine the state and city for computers on the AOL network. The regional and country level inaccuracy is due to the flexibility given to each ISP to reassign dynamic IP addresses within their service areas. Parameters: ipn  a network byte ordered IPv4 number, as returned by a function like ipgeo_ipa2ipn() or libnet_name2addr4(). After a successful call to ipgeo_lookup(), one or more calls to ipgeo_get_cc(), ipgeo_get_country(), ipgeo_get_region(), ipgeo_get_city(), and/or ipgeo_get_isp() may be made to obtain lookup information. flags  lookup parameters, or 0 for default ipg  pointer to a ipgeo context Returns: 1 on success, -1 on error Definition at line 77 of file libipg_lookup.c. References ipgeo_context::cc, ipgeo_context::city, ipgeo_context::country, ipgeo_context::db, IPGEO_BUF_SIZE, ipgeo_t, ipgeo_context::isp, ipgeo_context::latitude, ipgeo_context::longitude, and ipgeo_context::region. { int n; char *p, *q; u_int32_t min, max; char buf[IPGEO_BUF_SIZE]; if (ipg == NULL) { return (-1); } #if (LIBIPG_LIL_ENDIAN) ipn = htonl(ipn); #endif /* perform a linear search through the CSV file */ for (; fgets(buf, IPGEO_BUF_SIZE - 1, ipg->db); ) { if (buf[0] == '#') { /* ignore comments */ continue; } p = buf; /* step over quote */ p += 1; min = strtoul(strsep(&p, ","), (char **)NULL, 10); /* step over quote */ p += 1; max = strtoul(strsep(&p, ","), (char **)NULL, 10); if (ipn >= min && ipn <= max) { p += 1; q = strsep(&p, ","); for (n = 0; n < sizeof(ipg->cc) - 1; n++) { if (q[n] == '"') { ipg->cc[n] = NULL; break; } ipg->cc[n] = q[n]; } /* get cc */ p += 1; q = strsep(&p, ","); for (n = 0; n < sizeof(ipg->country) - 1; n++) { if (q[n] == '"') { ipg->country[n] = NULL; break; } ipg->country[n] = q[n]; } /* get country */ p += 1; q = strsep(&p, ","); for (n = 0; n < sizeof(ipg->region) - 1; n++) { if (q[n] == '"') { ipg->region[n] = NULL; break; } ipg->region[n] = q[n]; } /* get city */ p += 1; q = strsep(&p, ","); for (n = 0; n < sizeof(ipg->city) - 1; n++) { if (q[n] == '"') { ipg->city[n] = NULL; break; } ipg->city[n] = q[n]; } /* get latitude */ p += 1; ipg->latitude = strtod(strsep(&p, ","), (char **)NULL); /* get longitude */ p += 1; ipg->longitude = strtod(strsep(&p, ","), (char **)NULL); /* get isp */ p += 1; q = strsep(&p, ","); for (n = 0; n < sizeof(ipg->isp) - 1; n++) { if (q[n] == '"') { ipg->isp[n] = NULL; break; } ipg->isp[n] = q[n]; } rewind(ipg->db); return (1); } } /* no match */ return (0); }

char* ipgeo_get_cc (  ipgeo_t *  ipg  )

Returns the country code for the most recent ipgeo db lookup. The function must be called after a successful call to ipgeo_lookup(). Parameters: ipg  pointer to a ipgeo context Returns: the country code on success, NULL on error Definition at line 195 of file libipg_lookup.c. References ipgeo_context::cc, and ipgeo_t. { if (ipg->cc[0] == '-') { return("UNKNOWN"); } return (ipg->cc); }

char* ipgeo_get_country (  ipgeo_t *  ipg  )

Returns the country for the most recent ipgeo db lookup. The function must be called after a successful call to ipgeo_lookup(). Parameters: ipg  pointer to a ipgeo context Returns: the country code on success, NULL on error Definition at line 205 of file libipg_lookup.c. References ipgeo_context::country, and ipgeo_t. { if (ipg->country[0] == '-') { return("UNKNOWN"); } return (ipg->country); }

char* ipgeo_get_region (  ipgeo_t *  ipg  )

Returns the region for the most recent ipgeo db lookup. The function must be called after a successful call to ipgeo_lookup(). Parameters: ipg  pointer to a ipgeo context Returns: the country code on success, NULL on error Definition at line 215 of file libipg_lookup.c. References ipgeo_t, and ipgeo_context::region. { if (ipg->region[0] == '-') { return("UNKNOWN"); } return (ipg->region); }

char* ipgeo_get_city (  ipgeo_t *  ipg  )

Returns the city for the most recent ipgeo db lookup. The function must be called after a successful call to ipgeo_lookup(). Parameters: ipg  pointer to a ipgeo context Returns: the country code on success, NULL on error Definition at line 225 of file libipg_lookup.c. References ipgeo_context::city, and ipgeo_t. { if (ipg->city[0] == '-') { return("UNKNOWN"); } return (ipg->city); }

char* ipgeo_get_isp (  ipgeo_t *  ipg  )

Returns the isp for the most recent ipgeo db lookup. The function must be called after a successful call to ipgeo_lookup(). Parameters: ipg  pointer to a ipgeo context Returns: the country code on success, NULL on error Definition at line 235 of file libipg_lookup.c. References ipgeo_t, and ipgeo_context::isp. { if (ipg->isp[0] == '-') { return("UNKNOWN"); } return (ipg->isp); }

double ipgeo_get_lat (  ipgeo_t *  ipg  )

Returns the latitude for the most recent ipgeo db lookup. The function must be called after a successful call to ipgeo_lookup(). Parameters: ipg  pointer to a ipgeo context Returns: the latitude on success, 0 on error Definition at line 245 of file libipg_lookup.c. References ipgeo_t, and ipgeo_context::latitude. { return (ipg->latitude); }

double ipgeo_get_long (  ipgeo_t *  ipg  )

Returns the longitude for the most recent ipgeo db lookup. The function must be called after a successful call to ipgeo_lookup(). Parameters: ipg  pointer to a ipgeo context Returns: the longitude on success, 0 on error Definition at line 251 of file libipg_lookup.c. References ipgeo_t, and ipgeo_context::longitude. { return (ipg->longitude); }

---