Merge branch 'master'
[oweals/gnunet.git] / src / util / resolver.h
1 /*
2      This file is part of GNUnet.
3      Copyright (C) 2009, 2012 GNUnet e.V.
4
5      GNUnet is free software; you can redistribute it and/or modify
6      it under the terms of the GNU General Public License as published
7      by the Free Software Foundation; either version 3, or (at your
8      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      General Public License for more details.
14
15      You should have received a copy of the GNU General Public License
16      along with GNUnet; see the file COPYING.  If not, write to the
17      Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18      Boston, MA 02110-1301, USA.
19 */
20
21 /**
22  * @author Christian Grothoff
23  * @file util/resolver.h
24  */
25 #ifndef RESOLVER_H
26 #define RESOLVER_H
27
28 #include "gnunet_common.h"
29
30 GNUNET_NETWORK_STRUCT_BEGIN
31
32 /**
33  * Request for the resolver.  Followed by either the "struct sockaddr"
34  * or the 0-terminated hostname.
35  *
36  * The response will be one or more messages of type
37  * RESOLVER_RESPONSE, each with the message header immediately
38  * followed by the requested data (0-terminated hostname or struct
39  * in[6]_addr, depending on direction).  The last RESOLVER_RESPONSE
40  * will just be a header without any data (used to indicate the end of
41  * the list).
42  */
43 struct GNUNET_RESOLVER_GetMessage
44 {
45   /**
46    * Type:  GNUNET_MESSAGE_TYPE_RESOLVER_REQUEST
47    */
48   struct GNUNET_MessageHeader header;
49
50   /**
51    * GNUNET_YES to get hostname from IP,
52    * GNUNET_NO to get IP from hostname.
53    */
54   int32_t direction GNUNET_PACKED;
55
56   /**
57    * Address family to use (AF_INET, AF_INET6 or AF_UNSPEC).
58    */
59   int32_t af GNUNET_PACKED;
60
61   /* followed by 0-terminated string for A/AAAA-lookup or
62      by 'struct in_addr' / 'struct in6_addr' for reverse lookup */
63
64 };
65 GNUNET_NETWORK_STRUCT_END
66
67 #endif