gweb/gresolv.h

   1 /*
   2  *
   3  *  Resolver library with GLib integration
   4  *
   5  *  Copyright (C) 2009-2012  Intel Corporation. All rights reserved.
   6  *
   7  *  This program is free software; you can redistribute it and/or modify
   8  *  it under the terms of the GNU General Public License version 2 as
   9  *  published by the Free Software Foundation.
  10  *
  11  *  This program is distributed in the hope that it will be useful,
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  *  GNU General Public License for more details.
  15  *
  16  *  You should have received a copy of the GNU General Public License
  17  *  along with this program; if not, write to the Free Software
  18  *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  19  *
  20  */
  21
  22 #ifndef __G_RESOLV_H
  23 #define __G_RESOLV_H
  24
  25 #include <stdint.h>
  26
  27 #include <glib.h>
  28
  29 #ifdef __cplusplus
  30 extern "C" {
  31 #endif
  32
  33 struct _GResolv;
  34
  35 typedef struct _GResolv GResolv;
  36
  37 typedef enum {
  38         G_RESOLV_RESULT_STATUS_SUCCESS,
  39         G_RESOLV_RESULT_STATUS_ERROR,
  40         G_RESOLV_RESULT_STATUS_NO_RESPONSE,
  41         G_RESOLV_RESULT_STATUS_FORMAT_ERROR,
  42         G_RESOLV_RESULT_STATUS_SERVER_FAILURE,
  43         G_RESOLV_RESULT_STATUS_NAME_ERROR,
  44         G_RESOLV_RESULT_STATUS_NOT_IMPLEMENTED,
  45         G_RESOLV_RESULT_STATUS_REFUSED,
  46 } GResolvResultStatus;
  47
  48 typedef void (*GResolvResultFunc)(GResolvResultStatus status,
  49                                         char **results, gpointer user_data);
  50
  51 typedef void (*GResolvDebugFunc)(const char *str, gpointer user_data);
  52
  53 GResolv *g_resolv_new(int index);
  54
  55 GResolv *g_resolv_ref(GResolv *resolv);
  56 void g_resolv_unref(GResolv *resolv);
  57
  58 void g_resolv_set_debug(GResolv *resolv,
  59                                 GResolvDebugFunc func, gpointer user_data);
  60
  61 gboolean g_resolv_add_nameserver(GResolv *resolv, const char *address,
  62                                         uint16_t port, unsigned long flags);
  63 void g_resolv_flush_nameservers(GResolv *resolv);
  64
  65 guint g_resolv_lookup_hostname(GResolv *resolv, const char *hostname,
  66                                 GResolvResultFunc func, gpointer user_data);
  67
  68 gboolean g_resolv_cancel_lookup(GResolv *resolv, guint id);
  69
  70 gboolean g_resolv_set_address_family(GResolv *resolv, int family);
  71
  72 #ifdef __cplusplus
  73 }
  74 #endif
  75
  76 #endif /* __G_RESOLV_H */