src/gns/nss/nss_gns_query.h

   1 /*
   2      This file is part of GNUnet.
   3      Copyright (C) 2012 GNUnet e.V.
   4
   5      GNUnet is free software: you can redistribute it and/or modify it
   6      under the terms of the GNU Affero General Public License as published
   7      by the Free Software Foundation, either version 3 of the License,
   8      or (at your option) any later version.
   9
  10      GNUnet is distributed in the hope that it will be useful, but
  11      WITHOUT ANY WARRANTY; without even the implied warranty of
  12      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13      Affero General Public License for more details.
  14
  15      You should have received a copy of the GNU Affero General Public License
  16      along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17
  18      SPDX-License-Identifier: AGPL3.0-or-later
  19 */
  20 #ifndef NSS_GNS_QUERY_H
  21 #define NSS_GNS_QUERY_H
  22
  23 /**
  24  * Parts taken from nss-mdns
  25  */
  26 #include <inttypes.h>
  27
  28 /* Maximum number of entries to return */
  29 #define MAX_ENTRIES 16
  30
  31 typedef struct
  32 {
  33   uint32_t address;
  34 } ipv4_address_t;
  35
  36
  37 typedef struct
  38 {
  39   uint8_t address[16];
  40 } ipv6_address_t;
  41
  42
  43 struct userdata
  44 {
  45   int count;
  46   int data_len; /* only valid when doing reverse lookup */
  47   union  {
  48     ipv4_address_t ipv4[MAX_ENTRIES];
  49     ipv6_address_t ipv6[MAX_ENTRIES];
  50     char *name[MAX_ENTRIES];
  51   } data;
  52 };
  53
  54
  55 /**
  56  * Wrapper function that uses gnunet-gns cli tool to resolve
  57  * an IPv4/6 address.
  58  *
  59  * @param af address family
  60  * @param name the name to resolve
  61  * @param u the userdata (result struct)
  62  * @return -1 on internal error,
  63  *         -2 if request is not for GNS,
  64  *         -3 on timeout,
  65  *          else 0
  66  */
  67 int
  68 gns_resolve_name(int af,
  69                  const char *name,
  70                  struct userdata *userdata);
  71
  72 #endif