From: Matthias Wachs Date: Mon, 25 Oct 2010 09:22:15 +0000 (+0000) Subject: (no commit message) X-Git-Tag: initial-import-from-subversion-38251~19957 X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=b7033e01b3afcf20828e2c5cb9e8ec15a9f760c4;p=oweals%2Fgnunet.git --- diff --git a/src/transport/transport_selection.h b/src/transport/transport_selection.h index 951734b41..b1ebe7f15 100644 --- a/src/transport/transport_selection.h +++ b/src/transport/transport_selection.h @@ -25,8 +25,10 @@ */ /** - * The structs defined here are used by the transport plugin to tell ATS about the transport's properties like cost and quality - * and on the other side the structs are used by highlevel components to communicate the constraints they have for a transport to ATS + * The structs defined here are used by the transport plugin to tell ATS about + * the transport's properties like cost and quality and on the other side + * the structs are used by highlevel components to communicate the constraints + * they have for a transport to ATS * * +---+ * +-----------+ Constraints | | Plugin properties +---------+ @@ -42,7 +44,10 @@ /** * Enum defining all known property types for ATS * Enum values are used in the GNUNET_ATS_Information struct as (key,value)-pair - * Cost are always stored in uint32_t, so all units used to define costs have to be normalized to fit in uint32_t [0 .. 4.294.967.295] + * + * Cost are always stored in uint32_t, so all units used to define costs + * have to be normalized to fit in uint32_t [0 .. 4.294.967.295] + * * To keep the elements ordered * 1..1024 : Values with a relation to cost * 1025..2048 : Values with a relation to quality @@ -58,8 +63,10 @@ enum GNUNET_ATS_Property /** * Volume based cost in financial units to transmit data * - * Note: This value is not bound to a specific currency or unit and only used locally - * "cent" just refers the smallest amount of money in the respective currency + * Note: This value is not bound to a specific currency or unit and only + * used locally. + * "cent" just refers the smallest amount of money in the respective + * currency. * * Unit: [cent/MB] * @@ -74,8 +81,10 @@ enum GNUNET_ATS_Property /** * Time based cost in financial units to transmit data * - * Note: This value is not bound to a specific currency or unit and only used locally - * "cent" just refers the smallest amount of money in the respective currency + * Note: This value is not bound to a specific currency or unit and only + * used locally. + * "cent" just refers the smallest amount of money in the respective + * currency. * * Unit: [cent/h] * @@ -110,8 +119,8 @@ enum GNUNET_ATS_Property /** * Energy consumption * - * Energy consumption using this transport when sending with a certain power at a certain bitrate - * This is only an approximation based on: + * Energy consumption using this transport when sending with a certain + * power at a certain bitrate. This is only an approximation based on: * Energy consumption E = P / D * * with: @@ -138,7 +147,8 @@ enum GNUNET_ATS_Property /** * Connect cost - * How many bytes are transmitted to initiate a new connection using this transport? + * How many bytes are transmitted to initiate a new connection using + * this transport? * * Unit: [bytes] * @@ -146,10 +156,14 @@ enum GNUNET_ATS_Property * * Examples: * - * UDP (No connection) : 0 bytes - * TCP (TCP 3-Way handshake): 220 bytes Ethernet, 172 bytes TCP/IP, 122 bytes TCP - * HTTP (TCP + Header) : 477 bytes Ethernet, 429 bytes TCP/IP, 374 bytes TCP, 278 bytes HTTP - * HTTPS HTTP+TLS Handshake: 2129 bytes Ethernet, 1975 bytes TCP/IP, 1755 bytes TCP, 1403 bytes HTTPS + * UDP (No connection) : + * 0 bytes + * TCP (TCP 3-Way handshake): + * 220 bytes Ethernet, 172 bytes TCP/IP, 122 bytes TCP + * HTTP (TCP + Header) : + * 477 bytes Ethernet, 429 bytes TCP/IP, 374 bytes TCP, 278 bytes HTTP + * HTTPS HTTP+TLS Handshake: + * 2129 bytes Ethernet, 1975 bytes TCP/IP, 1755 bytes TCP, 1403 bytes HTTPS * * */ GNUNET_ATS_COST_CONNECT = 5, @@ -175,8 +189,10 @@ enum GNUNET_ATS_Property /** * Network overhead * - * How many bytes are sent over the wire when 1 kilobyte (1024 bytes) of application data is transmitted? - * A factor used with connect cost, bandwidth cost and energy cost to describe the overhead produced by the transport protocol + * How many bytes are sent over the wire when 1 kilobyte (1024 bytes) + * of application data is transmitted? + * A factor used with connect cost, bandwidth cost and energy cost + * to describe the overhead produced by the transport protocol * * Unit: [bytes/kb] * @@ -253,7 +269,8 @@ enum GNUNET_ATS_Property * LAN : 0 * WLAN : 400 * Bluetooth : 100 - * Note: This numbers are just assumptions as an example, not measured or somehow determined + * Note: This numbers are just assumptions as an example, not + * measured or somehow determined */ GNUNET_ATS_QUALITY_NET_ERRORRATE = 1030, @@ -269,7 +286,8 @@ enum GNUNET_ATS_Property * LAN : 0 * WLAN : 400 * Bluetooth : 100 - * Note: This numbers are just assumptions as an example, not measured or somehow determined + * Note: This numbers are just assumptions as an example, not + * measured or somehow determined */ GNUNET_ATS_QUALITY_NET_DROPRATE = 1031, @@ -285,7 +303,8 @@ enum GNUNET_ATS_Property * LAN : 0 * WLAN : 40 * Bluetooth : 10 - * Note: This numbers are just assumptions as an example, not measured or somehow determined + * Note: This numbers are just assumptions as an example, not measured + * or somehow determined */ GNUNET_ATS_QUALITY_NET_LOSSRATE = 1032, @@ -318,9 +337,11 @@ enum GNUNET_ATS_Property }; /** - * This structure will be used by plugins to communicate costs to ATS or by higher level components to tell ATS their constraints - * Always a pair of (GNUNET_ATS_Property, uint32_t value) - * Value is always uint32_t, so all units used to define costs have to be normalized to fit uint32_t + * This structure will be used by plugins to communicate costs to ATS or by + * higher level components to tell ATS their constraints. + * Always a pair of (GNUNET_ATS_Property, uint32_t value). + * Value is always uint32_t, so all units used to define costs have to + * be normalized to fit uint32_t. */ struct GNUNET_ATS_Information {