aboutsummaryrefslogtreecommitdiff
path: root/doc/documentation/chapters/developer.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/documentation/chapters/developer.texi')
-rw-r--r--doc/documentation/chapters/developer.texi12
1 files changed, 7 insertions, 5 deletions
diff --git a/doc/documentation/chapters/developer.texi b/doc/documentation/chapters/developer.texi
index ada6d37a0..a99f6a481 100644
--- a/doc/documentation/chapters/developer.texi
+++ b/doc/documentation/chapters/developer.texi
@@ -94,6 +94,7 @@ following links:
94@c ** FIXME: Link to files in source, not online. 94@c ** FIXME: Link to files in source, not online.
95@c ** FIXME: Where is the Java tutorial? 95@c ** FIXME: Where is the Java tutorial?
96@itemize @bullet 96@itemize @bullet
97@c broken link
97@item @uref{https://gnunet.org/git/gnunet.git/plain/doc/gnunet-c-tutorial.pdf, GNUnet C tutorial} 98@item @uref{https://gnunet.org/git/gnunet.git/plain/doc/gnunet-c-tutorial.pdf, GNUnet C tutorial}
98@item GNUnet Java tutorial 99@item GNUnet Java tutorial
99@end itemize 100@end itemize
@@ -273,7 +274,7 @@ library is a wapper around block plugins which provide the necessary
273functions for each block type. 274functions for each block type.
274@item @file{statistics/} --- statistics service 275@item @file{statistics/} --- statistics service
275The statistics service enables associating 276The statistics service enables associating
276values (of type uint64_t) with a componenet name and a string. The main 277values (of type uint64_t) with a component name and a string. The main
277uses is debugging (counting events), performance tracking and user 278uses is debugging (counting events), performance tracking and user
278entertainment (what did my peer do today?). 279entertainment (what did my peer do today?).
279@item @file{arm/} --- Automatic Restart Manager (ARM) 280@item @file{arm/} --- Automatic Restart Manager (ARM)
@@ -2450,7 +2451,7 @@ memcpy (tbuf, nameTrans, strlen (nameTrans) + 1);
2450 2451
2451Note that, here the functions @code{htonl}, @code{htons} and 2452Note that, here the functions @code{htonl}, @code{htons} and
2452@code{GNUNET_TIME_absolute_hton} are applied to convert little endian 2453@code{GNUNET_TIME_absolute_hton} are applied to convert little endian
2453into big endian, about the usage of the big/small edian order and the 2454into big endian, about the usage of the big/small endian order and the
2454corresponding conversion function please refer to Introduction of 2455corresponding conversion function please refer to Introduction of
2455Big Endian and Little Endian. 2456Big Endian and Little Endian.
2456 2457
@@ -7027,6 +7028,7 @@ bandwidth consumption.
7027 7028
7028@c %**end of header 7029@c %**end of header
7029 7030
7031@c inconsistent use of ``must'' above it's written ``MUST''
7030In contrast to GET operations, developers @strong{must} manually re-run 7032In contrast to GET operations, developers @strong{must} manually re-run
7031PUT operations periodically (if they intend the content to continue to be 7033PUT operations periodically (if they intend the content to continue to be
7032available). Content stored in the DHT expires or might be lost due to 7034available). Content stored in the DHT expires or might be lost due to
@@ -7055,7 +7057,7 @@ Using the monitoring API, applications can choose to monitor these
7055requests, possibly limiting themselves to requests for a particular block 7057requests, possibly limiting themselves to requests for a particular block
7056type. 7058type.
7057 7059
7058The monitoring API is not only usefu only for diagnostics, it can also be 7060The monitoring API is not only useful for diagnostics, it can also be
7059used to trigger application operations based on PUT operations. 7061used to trigger application operations based on PUT operations.
7060For example, an application may use PUTs to distribute work requests to 7062For example, an application may use PUTs to distribute work requests to
7061other peers. 7063other peers.
@@ -7149,7 +7151,7 @@ already knows more than about a thousand blocks may need to send
7149several of these messages. Naturally, the client should transmit these 7151several of these messages. Naturally, the client should transmit these
7150messages as quickly as possible after the original GET request such that 7152messages as quickly as possible after the original GET request such that
7151the DHT can filter those results in the network early on. Naturally, as 7153the DHT can filter those results in the network early on. Naturally, as
7152these messages are send after the original request, it is conceivalbe 7154these messages are sent after the original request, it is conceivalbe
7153that the DHT service may return blocks that match those already known 7155that the DHT service may return blocks that match those already known
7154to the client anyway. 7156to the client anyway.
7155 7157
@@ -7240,7 +7242,7 @@ A peer can search the DHT by sending @code{struct PeerGetMessage}s of type
7240@code{GNUNET_MESSAGE_TYPE_DHT_P2P_GET} to other peers. In addition to the 7242@code{GNUNET_MESSAGE_TYPE_DHT_P2P_GET} to other peers. In addition to the
7241usual information about the request (type, routing options, desired 7243usual information about the request (type, routing options, desired
7242replication level for the request, the key and the extended query), a GET 7244replication level for the request, the key and the extended query), a GET
7243request also again contains a hop counter, a Bloom filter over the peers 7245request also contains a hop counter, a Bloom filter over the peers
7244that have processed the request already and depending on the routing 7246that have processed the request already and depending on the routing
7245options the full path traversed by the GET. 7247options the full path traversed by the GET.
7246Finally, a GET request includes a variable-size second Bloom filter and a 7248Finally, a GET request includes a variable-size second Bloom filter and a