additional function to check option
[oweals/gnunet.git] / src / hello / address.c
1 /*
2      This file is part of GNUnet.
3      (C) 2009 Christian Grothoff (and other contributing authors)
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., 59 Temple Place - Suite 330,
18      Boston, MA 02111-1307, USA.
19 */
20
21 /**
22  * @file hello/address.c
23  * @brief helper functions for handling addresses
24  * @author Christian Grothoff
25  */
26 #include "platform.h"
27 #include "gnunet_hello_lib.h"
28 #include "gnunet_util_lib.h"
29
30
31 /**
32  * Check if an address has a local option set
33  *
34  * @param address the address to check
35  * @param option the respective option to check for
36  * @return GNUNET_YES or GNUNET_NO
37  */
38 int
39 GNUNET_HELLO_address_check_option (const struct GNUNET_HELLO_Address * address,
40     enum GNUNET_HELLO_AddressInfo option)
41 {
42   if (option == (address->local_info & option))
43     return GNUNET_YES;
44   return GNUNET_NO;
45 }
46
47 /**
48  * Get the size of an address struct.
49  *
50  * @param address address
51  * @return the size
52  */
53 size_t
54 GNUNET_HELLO_address_get_size (const struct GNUNET_HELLO_Address * address)
55 {
56   return sizeof (struct GNUNET_HELLO_Address) + address->address_length +
57         strlen (address->transport_name) + 1;
58 }
59
60
61 /**
62  * Allocate an address struct.
63  *
64  * @param peer the peer
65  * @param transport_name plugin name
66  * @param address binary address
67  * @param address_length number of bytes in 'address'
68  * @return the address struct
69  */
70 struct GNUNET_HELLO_Address *
71 GNUNET_HELLO_address_allocate (const struct GNUNET_PeerIdentity *peer,
72                                const char *transport_name, const void *address,
73                                size_t address_length,
74                                enum GNUNET_HELLO_AddressInfo local_info)
75 {
76   struct GNUNET_HELLO_Address *addr;
77   size_t slen;
78   char *end;
79
80   GNUNET_assert (transport_name != NULL);
81
82   slen = strlen (transport_name) + 1;
83   addr =
84       GNUNET_malloc (sizeof (struct GNUNET_HELLO_Address) + address_length +
85                      slen);
86   addr->peer = *peer;
87   addr->address = &addr[1];
88   end = (char *) &addr[1];
89   memcpy (end, address, address_length);
90   addr->address_length = address_length;
91   addr->transport_name = &end[address_length];
92   memcpy (&end[address_length], transport_name, slen);
93   return addr;
94 }
95
96
97 /**
98  * Copy an address struct.
99  *
100  * @param address address to copy
101  * @return a copy of the address struct
102  */
103 struct GNUNET_HELLO_Address *
104 GNUNET_HELLO_address_copy (const struct GNUNET_HELLO_Address *address)
105 {
106   return GNUNET_HELLO_address_allocate (&address->peer, address->transport_name,
107                                         address->address,
108                                         address->address_length, 0);
109 }
110
111
112 /**
113  * Compare two addresses.  Does NOT compare the peer identity,
114  * that is assumed already to match!
115  *
116  * @param a1 first address
117  * @param a2 second address
118  * @return 0 if the addresses are equal, -1 if a1<a2, 1 if a1>a2.
119  */
120 int
121 GNUNET_HELLO_address_cmp (const struct GNUNET_HELLO_Address *a1,
122                           const struct GNUNET_HELLO_Address *a2)
123 {
124   int ret;
125
126   ret = strcmp (a1->transport_name, a2->transport_name);
127   if (0 != ret)
128     return ret;
129   if (a1->address_length < a2->address_length)
130     return -1;
131   if (a1->address_length > a2->address_length)
132     return 1;
133   return memcmp (a1->address, a2->address, a1->address_length);
134 }
135
136
137 /* end of address.c */