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 <stdbool.h>
  26 #include <stdint.h>
  27
  28 #include <glib.h>
  29
  30 #ifdef __cplusplus
  31 extern "C" {
  32 #endif
  33
  34 struct _GResolv;
  35
  36 typedef struct _GResolv GResolv;
  37
  38 typedef enum {
  39         G_RESOLV_RESULT_STATUS_SUCCESS,
  40         G_RESOLV_RESULT_STATUS_ERROR,
  41         G_RESOLV_RESULT_STATUS_NO_RESPONSE,
  42         G_RESOLV_RESULT_STATUS_FORMAT_ERROR,
  43         G_RESOLV_RESULT_STATUS_SERVER_FAILURE,
  44         G_RESOLV_RESULT_STATUS_NAME_ERROR,
  45         G_RESOLV_RESULT_STATUS_NOT_IMPLEMENTED,
  46         G_RESOLV_RESULT_STATUS_REFUSED,
  47 } GResolvResultStatus;
  48
  49 typedef void (*GResolvResultFunc)(GResolvResultStatus status,
  50                                         char **results, gpointer user_data);
  51
  52 typedef void (*GResolvDebugFunc)(const char *str, gpointer user_data);
  53
  54 GResolv *g_resolv_new(int index);
  55
  56 GResolv *g_resolv_ref(GResolv *resolv);
  57 void g_resolv_unref(GResolv *resolv);
  58
  59 void g_resolv_set_debug(GResolv *resolv,
  60                                 GResolvDebugFunc func, gpointer user_data);
  61
  62 bool g_resolv_add_nameserver(GResolv *resolv, const char *address,
  63                                         uint16_t port, unsigned long flags);
  64 void g_resolv_flush_nameservers(GResolv *resolv);
  65
  66 guint g_resolv_lookup_hostname(GResolv *resolv, const char *hostname,
  67                                 GResolvResultFunc func, gpointer user_data);
  68
  69 bool g_resolv_cancel_lookup(GResolv *resolv, guint id);
  70
  71 bool g_resolv_set_address_family(GResolv *resolv, int family);
  72
  73 #ifdef __cplusplus
  74 }
  75 #endif
  76
  77 #endif /* __G_RESOLV_H */