/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 2; tab-width: 2 -*- */
/* GeoIPCity.h
 *
 * Copyright (C) 2006 MaxMind LLC
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */

#ifndef GEOIPCITY_H
#define GEOIPCITY_H

#include "GeoIP.h"

#ifdef __cplusplus
extern "C" {
#endif

#define  GEOIP_UNKNOWN_CONF  ( 0x7f )

typedef struct GeoIPRecordTag {
    char *country_code;
    char *country_code3;
    char *country_name;
    char *region;
    char *city;
    char *postal_code;
    float latitude;
    float longitude;
    union {
        int metro_code;   /* metro_code is a alias for dma_code */
        int dma_code;
    };
    int area_code;
    int charset;
    char *continent_code;
    int netmask;
} GeoIPRecord;

GeoIPRecord * GeoIP_record_by_ipnum(GeoIP * gi, unsigned long ipnum);
GeoIPRecord * GeoIP_record_by_addr(GeoIP * gi, const char *addr);
GeoIPRecord * GeoIP_record_by_name(GeoIP * gi, const char *host);

GeoIPRecord * GeoIP_record_by_ipnum_v6(GeoIP * gi, geoipv6_t ipnum);
GeoIPRecord * GeoIP_record_by_addr_v6(GeoIP * gi, const char *addr);
GeoIPRecord * GeoIP_record_by_name_v6(GeoIP * gi, const char *host);

int GeoIP_record_id_by_addr(GeoIP * gi, const char *addr);
int GeoIP_record_id_by_addr_v6(GeoIP * gi, const char *addr);

int GeoIP_init_record_iter(GeoIP * gi);
/* returns 0 on success, 1 on failure */
int GeoIP_next_record(GeoIP * gi, GeoIPRecord **gir, int *record_iter);

void GeoIPRecord_delete(GeoIPRecord *gir);

/* NULL on failure otherwise a malloced string in utf8 */
/* char * GeoIP_iso_8859_1__utf8(const char *); */

#ifdef __cplusplus
}
#endif

#endif /* GEOIPCITY_H */
