/* vim: set expandtab ts=4 sw=4: */ /* * You may redistribute this program and/or modify it under the terms of * the GNU General Public License as published by the Free Software Foundation, * either version 3 of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ #ifndef Address_H #define Address_H #include "benc/String.h" #include "memory/Allocator.h" #include "util/Linker.h" Linker_require("dht/Address.c"); #include #include #define Address_KEY_SIZE 32 #define Address_NETWORK_ADDR_SIZE 8 #define Address_SEARCH_TARGET_SIZE 16 #define Address_SERIALIZED_SIZE 40 // Don't undefine this yet, new code will depend on it so that it can be tracked down and changed. #define Address_ROT64 struct Address { /** The protocol version of the node. */ uint32_t protocolVersion; /** unused */ uint32_t padding; union { struct { // tricksy: this is effectively a 64 bit rotate of the following bytes array uint32_t three_be; uint32_t four_be; uint32_t one_be; uint32_t two_be; } ints; struct { uint64_t two_be; uint64_t one_be; } longs; uint8_t bytes[Address_SEARCH_TARGET_SIZE]; } ip6; uint8_t key[Address_KEY_SIZE]; uint64_t path; }; #define Address_SIZE (8 + Address_SEARCH_TARGET_SIZE + Address_KEY_SIZE + Address_NETWORK_ADDR_SIZE) Assert_compileTime(sizeof(struct Address) == Address_SIZE); struct Address_List { int length; struct Address* elems; }; struct Address_List* Address_List_new(uint32_t length, struct Allocator* alloc); uint32_t Address_getPrefix(struct Address* addr); uint32_t Address_prefixForIp6(uint8_t ip6[16]); uint32_t Address_prefixForSearchTarget(const uint8_t searchTarget[16]); /** * Address_serialize and Address_parse use the following format: * * 1 2 3 * 0 1 2 3 4 5 6 7 0 1 2 3 4 5 6 7 0 1 2 3 4 5 6 7 0 1 2 3 4 5 6 7 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ * 0 | | * + + * 4 | | * + + * 8 | | * + + * 12 | | * + Public Key + * 16 | | * + + * 20 | | * + + * 24 | | * + + * 28 | | * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ * 32 | | * + Route Label + * 36 | | * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ */ void Address_serialize(uint8_t output[Address_SERIALIZED_SIZE], const struct Address* addr); void Address_parse(struct Address* addr, const uint8_t input[Address_SERIALIZED_SIZE]); bool Address_isSame(const struct Address* addr, const struct Address* addr2); bool Address_isSameIp(const struct Address* addr, const struct Address* addr2); bool Address_equalsSearchTarget(struct Address* addr, const uint8_t searchTarget[Address_SEARCH_TARGET_SIZE]); void Address_forKey(struct Address* out, const uint8_t key[Address_KEY_SIZE]); void Address_printIp(uint8_t output[40], struct Address* addr); void Address_printShortIp(uint8_t output[40], struct Address* addr); void Address_print(uint8_t output[60], struct Address* addr); String* Address_toString(struct Address* addr, struct Allocator* alloc); String* Address_toStringKey(struct Address* addr, struct Allocator* alloc); struct Address* Address_fromString(String* str, struct Allocator* alloc); struct Address* Address_clone(struct Address* orig, struct Allocator* alloc); int Address_xorcmp(uint32_t target, uint32_t negativeIfCloser, uint32_t positiveIfCloser); /** * Return which node is closer to the target. * * @param target the address to test distance against. * @param negativeIfCloser one address to check distance. * @param positiveIfCloser another address to check distance. * @return -1 if negativeIfCloser is closer to target, 1 if positiveIfCloser is closer * 0 if they are both the same distance. */ int Address_closest(struct Address* target, struct Address* negativeIfCloser, struct Address* positiveIfCloser); #endif