/*
This file is part of GNUnet
- (C) 2002-2013 Christian Grothoff (and other contributing authors)
+ Copyright (C) 2002-2014 GNUnet e.V.
GNUnet is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
You should have received a copy of the GNU General Public License
along with GNUnet; see the file COPYING. If not, write to the
- Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- Boston, MA 02111-1307, USA.
+ Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ Boston, MA 02110-1301, USA.
*/
-
/**
* @file transport/plugin_transport_http_common.c
* @brief functionality shared by http client and server transport service plugin
* @author Matthias Wachs
+ * @author Christian Grothoff
*/
-
#include "platform.h"
#include "gnunet_common.h"
#include "gnunet_transport_plugin.h"
#define HTTP_DEFAULT_PORT 80
#define HTTPS_DEFAULT_PORT 443
-enum HTTP_ADDRESS_OPTIONS
+/**
+ * Bits in the `options` field of HTTP addresses.
+ */
+enum HttpAddressOptions
{
+ /**
+ * No bits set.
+ */
HTTP_OPTIONS_NONE = 0,
- HTTP_OPTIONS_VERIFY_CERTIFICATE = 1
+
+ /**
+ * Verify X509 server certificate, it should be valid.
+ * (if this bit is not set, it is probably just self-
+ * signed and not expected to be verified).
+ */
+ HTTP_OPTIONS_VERIFY_CERTIFICATE = 1,
+
+ /**
+ * Enable TCP Stealth-style port knocking.
+ */
+ HTTP_OPTIONS_TCP_STEALTH = 2
};
{
/**
* Address options
+ * see `enum HttpAddressOptions`
*/
uint32_t options;
GNUNET_NETWORK_STRUCT_END
-struct SplittedHTTPAddress;
+/**
+ * Representation of HTTP URL split into its components.
+ */
+struct SplittedHTTPAddress
+{
+ char *protocol;
+ char *host;
+ char *path;
+ int port;
+};
+
+/**
+ * Split an HTTP address into protocol, hostname, port
+ * and path components.
+ */
struct SplittedHTTPAddress *
http_split_address (const char *addr);
*
* @param plugin name of the plugin
* @param addr binary address
- * @param addrlen length of the address
+ * @param addrlen length of @a addr
* @return string representing the same address
*/
const char *
* Compare addr1 to addr2
*
* @param addr1 address1
- * @param addrlen1 address 1 length
+ * @param addrlen1 length of @a address1
* @param addr2 address2
- * @param addrlen2 address 2 length
+ * @param addrlen2 length of @a address2
* @return #GNUNET_YES if equal, #GNUNET_NO else
*/
size_t
const void *addr2,
size_t addrlen2);
+
+/**
+ * Function obtain the network type for an address.
+ *
+ * @param env the environment
+ * @param address the address
+ * @return the network type
+ */
+enum GNUNET_ATS_Network_Type
+http_common_get_network_for_address (struct GNUNET_TRANSPORT_PluginEnvironment *env,
+ const struct GNUNET_HELLO_Address *address);
+
+
/* end of plugin_transport_http_common.h */