2008-12-19 23:49:03 +00:00
|
|
|
/* geoip_db.h
|
2008-10-27 04:50:57 +00:00
|
|
|
* GeoIP database support
|
|
|
|
*
|
|
|
|
* $Id$
|
|
|
|
*
|
|
|
|
* Copyright 2008, Gerald Combs <gerald@wireshark.org>
|
|
|
|
*
|
|
|
|
* Wireshark - Network traffic analyzer
|
|
|
|
* By Gerald Combs <gerald@wireshark.org>
|
|
|
|
* Copyright 1998 Gerald Combs
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU General Public License
|
|
|
|
* as published by the Free Software Foundation; either version 2
|
|
|
|
* of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License
|
|
|
|
* along with this program; if not, write to the Free Software
|
|
|
|
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
|
|
*/
|
|
|
|
|
2008-12-19 23:49:03 +00:00
|
|
|
#ifndef __GEOIP_DB_H__
|
|
|
|
#define __GEOIP_DB_H__
|
2008-10-27 04:50:57 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Init function called from epan.h
|
|
|
|
*/
|
2008-12-19 23:49:03 +00:00
|
|
|
extern void geoip_db_init(void);
|
2008-10-27 04:50:57 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Number of databases we have loaded
|
|
|
|
*
|
|
|
|
* @return The number GeoIP databases successfully loaded
|
|
|
|
*/
|
2008-12-23 18:56:31 +00:00
|
|
|
extern guint geoip_db_num_dbs(void);
|
2008-10-27 04:50:57 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Fetch the name of a database
|
|
|
|
*
|
|
|
|
* @param dbnum Database index
|
2008-12-19 23:49:03 +00:00
|
|
|
* @return The database name or "Invalid database"
|
2008-10-27 04:50:57 +00:00
|
|
|
*/
|
2008-12-23 18:56:31 +00:00
|
|
|
extern const gchar *geoip_db_name(guint dbnum);
|
2008-10-27 04:50:57 +00:00
|
|
|
|
2008-12-19 23:49:03 +00:00
|
|
|
/**
|
|
|
|
* Fetch the database type. Types are enumerated in GeoIPDBTypes in GeoIP.h.
|
|
|
|
*
|
|
|
|
* @param dbnum Database index
|
|
|
|
* @return The database type or -1
|
|
|
|
*/
|
2008-12-23 18:56:31 +00:00
|
|
|
extern int geoip_db_type(guint dbnum);
|
2008-12-19 23:49:03 +00:00
|
|
|
|
2008-10-27 04:50:57 +00:00
|
|
|
/**
|
|
|
|
* Look up an IPv4 address in a database
|
|
|
|
*
|
|
|
|
* @param dbnum Database index
|
|
|
|
* @param addr IPv4 address to look up
|
2008-12-19 23:49:03 +00:00
|
|
|
* @param not_found The string to return if the lookup fails. May be NULL.
|
|
|
|
* @return The database entry if found, else not_found
|
2008-10-27 04:50:57 +00:00
|
|
|
*/
|
2008-12-23 18:56:31 +00:00
|
|
|
extern const char *geoip_db_lookup_ipv4(guint dbnum, guint32 addr, char *not_found);
|
2008-10-27 04:50:57 +00:00
|
|
|
|
2008-10-27 20:35:52 +00:00
|
|
|
/**
|
|
|
|
* Get all configured paths
|
|
|
|
*
|
|
|
|
* @return String with all paths separated by a path separator
|
|
|
|
*/
|
2008-12-19 23:49:03 +00:00
|
|
|
extern gchar *geoip_db_get_paths(void);
|
2008-10-27 20:35:52 +00:00
|
|
|
|
2008-12-19 23:49:03 +00:00
|
|
|
#endif /* __GEOIP_DB_H__ */
|